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How does your garden grow? 
Perfectly with Raspberry Pi 


Motion-sensing mirror lights up 
when it detects humans 


Discover visual programming 
for Internet of Things projects 
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> SIMULATE CIRCUITS ON YOUR RASPBERRY PI 
> BUILD A PROFESSIONAL PI PODCAST STATION 
> MEARM PI ROBOTIC ARM TESTED & RATED 
> SPOOKY HALLOWEEN HEAD N RON COLLIDER 


The Raspberry Pi camera that 
prints out animated images 
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CanakKit Raspberry Pi 3 Ultimate Starter Kit 
Model B | 1 GB RAM | 1.2 GHz | Quad-Core CPU 


> Learn to Code 
> Explore Computing 
> Get started with Electronics 


KiT INCLUDES RASPBERRY Pi 3 AND... 


PREMIUM 
HDMI CABLE 


2.5A 
POWER ADAPTER 


32 GB CLass 10 
MicroSD Carb 


USB MicroSD 
CARD READER 


PREMIUM CASE & 
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QUICK-START GUIDE 


PRE-LOADED 
WITH OPERATING SYSTEM 
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EGO is one of the most wonderful things ls '¥ LE G 
| Pi 


Ras 


in the world. From the 1980s ‘What it is pberry 
is beautiful’ advert, to The LEGO Movie, it _ /: | i WIND ¢300 Roo kn 
has provided inspiration that spans generations. | | : ! 
LEGO was also the universally loved toy when 
The MagPi team was young. It has been a constant 
presence through our lives, regardless of our ages 
or backgrounds. 

I like to think there’s a lot that Raspberry Pi 
and LEGO have in common, and the team’s been 
hankering after making a LEGO feature for a while. 
It’s not just childhood nostalgia — we feel it’s just 
as useful for adults. The free-range creativity that SEE PAGE 30 FOR DETAILS 
makes LEGO so much fun when you’re a kid is what 
makes it useful as a digital maker. You can make 
just about anything, given enough LEGO bricks. 

Our LEGO and Raspberry Pi feature (page 16) 
is spectacular. You will learn how to build LEGO 
robots that solve Rubik’s Cubes, Segway-style 
self-balancing robots, and retro NES games 
consoles; and marvel at a huge bunch of incredible 
community builds based on LEGO. AO IMAGE EDITING ON YOUR PI 

So don’t be afraid to add some LEGO to your | , | 

ee Our guide to improving your photos 

projects. It’s a versatile building material that 
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16 LEGO AND RASPBERRY PI 
What will you build? 


you can use, and reuse, across a range of builds. 44 SPOOKY HALLOWEEN PROJECT 
Everything is awesome! Can you control Head 'n Ron? 

Lucy Hattersley 66 WEEKEND PROJECTS 

Editor - The MagPi Make something amazing with your Pi this weekend 
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TUTORIALS 


> PI 101 — EDITING IMAGES 40 


Learn how to touch up your photos 


>PI101- WORKING WITH PDFS 42 


Our guide to reading and editing PDFs on Pi 


> BUILD AHALLOWEEN GAME 44 


The Head ‘n Ron Collider is this year's spooky project! 


> RECORD AND EDIT PODCASTS 50 


Use your Pi to make and publish web radio shows 


> SIMULATE CIRCUITS 02 


Use Xyce to simulate your circuit ideas 


> GET STARTED WITH NODE-RED 54 


The visual programming language for loT 


> HYDROPONICS WITH PI 08 


Monitor your vertical gardens with this special project 
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Meet the newest version of Raspbian 
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LEGO AND PI 


ASTRO PI 
UPGRADE 


The search begins for 


next-gen space scientists 
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TURTLE ROVER INTERVIEW 82 


An outdoor rover designed by Mars Rover engineers 


THIS MONTH IN RASPBERRY PI 84 


What else happened this month? 
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MOONHACK REPORT 88 
Young coders break a space record 
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Record GIFs on a retro camera COMMUNITY PROFILE 90 
This month's community profile star is Cat Lamin 
EVENTS 92 
CAMERA CAP Places to go to learn about coding and Pi 
It's like a dash cam, but for your body LETTERS 94 


Have questions? We have answers 


MESMERIC MIRROR 36 


This mirror knows when 
you're checking yourself out 
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How to build your own 
touchscreen music app 


MEARM PI 74 
WIRELESS CONTROLLER 76 
MONKMAKESDUINO LCD KIT 78 
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News 


RASPBIAN 


STRETCHES OUT 


Meet Stretch, and discover all the new features in Raspbian 


he latest version of 
Raspbian has been 
released. Code-named 
Stretch (named after the purple 
octopus of Toy Story 3), there area 
few under-the-hood changes that 
should simplify some aspects of 
working with a Raspberry Pi. 

Unlike last year’s Jessie update, 
there’s not much visual change 
between the previous version 
Jessie, the plucky cowgirl) and 
Stretch. However, you don’t 
have to dig too deep to find some 
useful updates. 

Multiple users are handled 
better under Stretch. Raspberry 
Pi Foundation UX Engineer 


Simon Long explains that this is 
“something we have done to make 
life easier for schools and the like 
[e.g. Code Clubs and CoderDojos], 
which want to use multiple users 
on a single Pi.” 

“The Raspberry Pi Configuration 
application no longer assumes 
that it will always be run by the 
‘pi’ user,” explains Simon. “Tf this 
is used to enable automatic login, 
it now sets it up for the current 
user. If passwordless sudo has 
been disabled for the current user, 
applications which require sudo 
will now prompt for a password 
at start rather than just failing 
to launch.” 


THONNY (SIMPLE MODE) 


Thonny Python IDE has been 
updated with a new Simple 


Mode, available as a second app 
(click Menu > Programming > 
Thonny (Simple Mode). 

Simple Mode strips Thonny 
down to the bare essentials 
required for starting with 
Python. It removes the 
configurable layout options in 
favour of a fixed selection of 
useful windows. The menus 
have been removed and larger 
captioned icons included. These 
are more immediately visible, 
and enable users to Save, Load, 
Run/Stop and Debug scripts. 

We expect Thonny (Simple 
Mode) to be very useful for 


Python training. 
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Of Bluetooth 

and databases 

Bluetooth support in Stretch 

is now handled by bluez-alsa 
rather than PulseAudio. As 
Simon clarifies, “the previous 
approach using PulseAudio was a 
bit clumsy, and necessitated my 
taking control of PulseAudio and 
Starting and stopping it when 
Bluetooth devices were selected 
or removed.” 

Stretch frees PulseAudio for 
use in other projects (you'll need 
to install it first), while “the 
change does also make things 
tidier inside the code itself,” 
according to Simon, who confirms 


Thonny - /honme/pulachonaloy: a 11. b4 
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“there should be no significant 
differences in [Bluetooth] 
performance or quality.” 

As Raspbian follows Debian’s 
update schedule, MySQL has coagaye tat cheese ies spaces ees olstgedl lis pen 


Download the latest version of Raspbian 


from www.raspberrypi.org/downloads 


been dropped in favour of : pesiienrealat 
SEpCean COMME Pru ihe wath phen ar QUCdDCM, Daren 
MariaDB (mariadb.com). src general use. ttitas Python Screech, Sonic Pt. Java, Mlathematica end more 
Simon explains that “we follow The option wth Dekop image conned n te ZF arte ove 4B 
Debian except in cases where ysl ape pstipye mnanien: cate les ani enden eas 
a) we have added a package pi ey eee eae eo ulna oma 
ourselves or b) we have fixed a ds rect 
bug or changed functionality in a RASPBIAN STRETCH WITH RASPBIAN STRETCH LITE 
Debian package. As this is neither reuse  a wa 
of those cases, we simply follow see ae ae a “0 
Debian.” Simon also notes that, reauseraiee 


as Debian drops PHP5 for PHP7, 
so does Raspbian. 


fim bead See eae ad a a ee TR Tae ie ie de Pk 
SDE ye 2 Pe 


Raspbian Stretch will ‘make life easier for 
schools and the like, which want to use 
multiple users on a single Pi 


If your build relies on MySQL “includes a lot of new functionality — with the virtual Sense HAT as well 
and you don’t fancy porting it in terms of input/output.” as the real thing. Look under More 
to MariaDB, you can still install Chromium has been updated to Blocks and select Add an Extension. 
MySQL on Stretch. version 60, which may run “slightly It’s best to do a clean install 

faster than before” thanks tosome _ of Stretch (back up any data on 
Other updates code optimisations. your Jessie-based system first) 
Raspbian Stretch ships with Scratch 2 receives the Sense HAT by downloading the image from 
Sonic Pi 3.0.1, which Simon says extension, allowing you to tinker magpi.cc/2eHd8M3. 


WHEEZY RASPBIAN JESSIE ALL NEW DESKTOP 
July 2012 September 2015 September 2016 

Before Raspbian, there was Debian, but The first major overhaul of Raspbian Just a year later, Jessie saw a massive 
Raspbian was the ARM port of Debian to saw, in Simon Long's words, update to its visual desktop interface. 
run on the Raspberry Pi. Raspbian was “modifications to the underlying system With gorgeous background images 
created by Mike Thompson and Peter to improve system processes” as well and a modern treatment for icons, 
Green as an independent project. The as desktop interface updates, such menus, window frames, and scrollbars, 
numerous tweaks and performance as booting to the desktop rather than Raspbian with the Pi Desktop is every 
improvements made Raspbian a highly the command line. LibreOffice, Claws bit as slick as operating systems 
customised environment, eventually Mail, and a GUI version of raspi-config running on hardware a hundred times 
becoming the offically supported OS. were added. more expensive. 
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News 


INTELLIGENT MUSEUMS 


A bespoke experience for every visitor 


hrewsbury Museum 
& Art Gallery 
(magpi.cc/2vIdFEB) 
hosted a week-long hack, allowing 
Microsoft and consultancy firm 
Black Radley (blackradley.com) 
to create an intelligent exhibit. 
While many museums use 
multimedia elements for certain 
exhibits, these videos or talks are 
the same, whether a child ora 
Oo Vea Cll aciinaies Une, Uae 
hack team wanted to do better. 
The aim was to make a system 
that would serve content suited to 
the demographic and engagement 
of the visitor. 


Open source 

Integral to the brief was that the 
project should use open-source 
software and hardware costing 
less than £100, so an old webcam 
and speaker were hooked up toa 


INTELLIGENT 
MUSEUMS 
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Raspberry Pi 3. The Pi used a UWP 
(Universal Windows Platform) 
on Windows IoT Core to access 
facial recognition algorithms via 
Microsoft’s Cognitive Services 
Pace A Pl 

Black Radley’s Joe Collins 
explains that “using a webcam 
gives us a bit of flexibility because 


Keeping the project open-source 
allows the museums to adapt the 


| deaf L 


Twice + pals Mare 
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device to their own needs 


they often come with quite 
a long cable.” 

Hack collaborator and Microsoft 
Technology Evangelist Martin 
Kearn adds that the use of 
Windows IoT Core “enables us 
to support almost any webcam 
that is supported on Windows, 
on any device.” 


Left In true hacker style, this was the 
plan for the device 


Above The device uses a webcam that was 
“languishing in the back of the cupboard” 


Joe explains that the Pi 3 was 
used because “it is handy to have 
the USB sockets for the webcam 
and to power the speakers.” 

You could use the project code 
(magpi.cc/2gCYfqQ) on a Pi 
Zero W, or as Martin points out, 
on “laptops, desktops, tablets, 
phones, Xbox, 80-inch Surface 
Hubs”, or anything that can run 
Windows 10. 

It was important to the hack 
team that the project was open- 
source because, as Joe tells us, 
“there are a lot of museums out 
there [...]. Keeping the project 
open-source allows the museums 
to adapt the device to their 
own needs.” 

Martin adds that “Microsoft 
is a big advocate of open-source 
technologies [...]. When we 
engage in ‘code with’ activities 
with customers and partners, we 
always like the project itself to be 
open-source.” 
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Wireless Wireless microSD card WD PiDrive WD PiDrive Raspberry Pi 3 5V 3A Black Square 
Keyboard Mouse with preloaded Cable Foundation Power Supply 6x6" Enclosure 
software Edition 375GB and USB Cable 


VWITH WD PIDRIVE COMPUTE CENTRE 


Includes custom NOOBS, Raspbian PIXEL, and Raspbian Lite on a bundled 
SD card. Organize multiple projects in one place with Project Spaces and 
easily assemble components in a custom enclosure. 


@ WD LABS Learn more at wdlabs.io 


Western Digital, WD, the WD logo, WDLabs, Project Spaces, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark 


of the Raspberry Pi Foundation. microSD is a trademark of SD-3C, LLC, All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies 
depending on operating environment. Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 
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AIY PROJECTS 
VOICE KITS 


Pre-order your Google AIY Projects Voice Kit 


The new AIY kit 


comes with a 76-page The 
MagPi Essentials book to 
guide you from cardboard 
to complete build 


The new kit is easier 

to build, with “a vastly 
improved API" to make 
projects easier to create 


10 October 2017 


ollowing overwhelming 
popularity of the free 
Google AIY Voice Kits 
we offered with issue 57, the 
kits are being made and sold 
as Standalone products. 
You can pre-order kits 
in the UK from The Pi Hut 
(magpi.cc/2hkKbCI) and 
Pimoroni (pimoroni.com/aiy) 
for £25, or in the US from Micro 
Center (magpi.cc/2heOVxa). 


long as there 1s 
demand, we plan to 
keep making them 


The new kits are easier to 
assemble than the initial freebies, 
with “a vastly improved API that 
makes it a lot easier to program” 
according to our own Editor, 

Lucy Hattersley. 

The kit will also come with a 
76-page The MagPi Essentials book 
to get you started. As Lucy puts it: 
“The new AIY Projects Essentials 
book is a brilliant introduction to 
voice recognition technology using 
Google Assistant SDK and Google 
Speech APIs.” 


The kits are made and 
distributed by US retailer Micro 
Center (www.microcenter.com), 
as merchandise manager 
Samantha Snyder explains: 
“Originally, we approached 
Google with a large order of kits 
to give away to our customers 
who purchase a Raspberry Pi 3, 
after the massive demand for 
The MagPi kit.” 

“We immediately volunteered 
to handle manufacturing and 
logistics,” she adds. 


Sold out? 


You shouldn’t have to worry 
about the kits selling out: “as 
long as there is demand, we plan 
to keep making them,” confirms 
Samantha. Micro Center has 
“been tracking their demand 
closely to ensure they will stay 
in stock,” she tells us. 

Pimoroni director Jon 
Williamson agrees: “Initial unit 
count shouldn’t be an issue ... we 
expect to be able to get hold of as 
many as needed, within reason.” 

Samantha also confirms that 
“We plan to work with Google and 
the Raspberry Pi Foundation to 
provide feedback on the kits.” The 
future of AIY Projects is bright. 
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‘ULTIMATE 


EDUCATION .- 


LIST 


As essential as a multimeter or microscope 


he Raspberry Pi 3 has Global head of PR and External 
made Farnell elementi4’s Communication, Holly Smart, 
ultimate education list, explains why the Pi 3 was chosen: 
making a Pi3 as indispensable “We believe the Pi 3 has one 
to the engineer as a multimeter, of the best SBC [single-board 
oscilloscope or 3D printer. computer] propositions on the 
Farnell element14 is a major market: compatibility, community 
Europe-wide distributor of support, ecosystem, software, 
electronics, technology and and tutorials; combined with 


We believe the P13 has one 
of the best SBC propositions 
on the market 


electronic system designs, and the performance-to-price ratio, 
maintenance and repair services. that’s fantastic.” 

Farnell elementi4’s Business Farnell directly helps in 
President for Sales and Marketing the training of engineers too, 
Europe, Peter Birks, says of the as Holly tells us: “Farnell 


list, “Supporting the education of staff regularly support local 
engineers is vital to ensure that the schools and universities with 
next generation has the talent to coding clubs, science fairs, 
drive our industry forward.” and general electronics.” 


The Pi 3 is as essential and useful as this £5,500 Keysight N6705C Power Analyser 


 ENCRRAT 0 ee eee 


raspberrypi.org/magpi 


The stories we shared 
that flew around the world 


magpi.cc/2wkkThL 


Now you can use Raspbian on your laptop or desktop 
PC. Just download the image from rpf.io/x86 (or use 
the DVD mounted on the front of issue 60) and install 
it to a USB drive using Etcher (etcher.io). Boot from the 
USB drive to replace Windows or macOS with a fast, 
modern, and secure alternative. 


magpi.cc/2wgLo7N 


The Eltechs ExaGear Desktop allows you to run any 
software on a Raspberry Pi, whether that's Windows 
games, standard x86 Linux software, Microsoft Office 
or even a browser that will display Netflix video. In our 
review, we concluded, ‘ExaGear is worth its lifetime 
price if you need a specific piece of x86 software: 


magpi.cc/2vTqSG4 


The Sony UK TEC manufacturing plant in Pencoed, 
South Wales, was originally contracted to make 10,000 
Raspberry Pis. Five years later, the factory has just 
produced its ten millionth. In fact, one million Raspberry 
Pi boards were made in the first year alone - quite the 
achievement considering that tentative first order. 
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PI POWER SWITCH 


Hackable board adds sofa-based power control 


resh from Kickstarter 
success, the Nanomesher 
Hackable Switch has 
hit the shelves. The device sits 
between the power supply and 
the Pi’s power input, essentially 
adding a remote-controlled power 
switch to the Pi. 

The ‘hackable’ trick with the 
device is its socket-mounted 
ATtiny85 Arduino Development 
MCU. Lift this chip from its seat, 
plug it into a breadboard, and you 
can reprogram it to behave as 
you like. 

Nanomesher provides a guide to 
reprogramming the teeny ATtiny 
chip: magpi.cc/2wDfrnz. 

Tech tester and ModMyPi CEO 
Jacob Marsh wanted to stock the 


Cc 


device because it’s a “very nice 
power switch, with some added 
hackability features. What’s not to 
likee We especially liked the fact 
that it comes pre-assembled with 
an IR remote, all ready to rock.” 
Alas, the IR input of the 
hackable power switch means 
it’s incompatible with the (RF) 
OSMC Remote Control. The 
hackable power switch is available 
now from ModMyPi for £22 
(magpi.cc/2eHjqeA). 


An IR, 
remote-controlled 
power switch with 
hackability 


ANDROID THINGS 
ENHANCES PI SUPPORT 


New Pi-specific features for better IoT devices 


oogle has added a few 

Pi-specific updates to the 

latest build of its Internet 
of Things OS, Android Things. 


android 
tnings 


Developer Advocate for IoT, 
Wayne Piekarski, points to two 
major updates in Android Things 
DP5: OpenGL ES 2.0 support and 
WebView. Both of these features 
were “highly requested features 
from developers,” according 
to Wayne. 


Flexible connections 
OpenGL ES 2.0 is a graphical 

API for 2D and 3D graphics, so 

we can expect more visually 
impressive Pi-based Android 
Things interfaces. WebView allows 


web-like content (basic HTML, 
for example) without the extras. 
JavaScript, HTML5 video and so 
on can be ‘injected’ back into the 
page, as detailed in the WebView 
manual (magpi.cc/2wCCqki). As 
such, WebView might prove to be a 
handy way to connect with an IoT 
device as quickly and responsively 
as possible. 

Finally, Android Things DP5 
adds dynamic pin muxing 
for the Pi 3, “with pins being 
configured at runtime depending 
on what features are being used,” 


Above The latest loT OS from Google includes some - 
Wayne clarifies. 


“highly requested features” for Pisupport the opposite: it’s an API to show 
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ASTROP! Beh 


he Astro Pi team is putting real scientists to design their own 
together a new payload to programs and experiments. 


A S | R _ I | | S @ upgrade the two Raspberry “We’re preparing young people 
Pi units on board the International for the jobs of the future,” says 
Space Station. Dave Honess, Astro Pi Programme 


The upgrade, due to launch in Manager. “We want to show 
January 2018, will provide two USB the possibilities of computer 
WiFi dongles, five optical filters, programming as a digital skill, 
and four 32GB microSD cards for and encourage young people of 
IS S up gerade will add WiFi do ngle S the two Astro Pi units, nicknamed school age towards further study 
: ° “eal ehanel Ae, of STEM subjects and associated 
to Astro Pl units Alongside the new launch comes careers — Astro Pi being especially 
a new set of missions for students. relevant to the aerospace industry, 
Astro Pi is searching for the next which will see huge growth over the 
generation of space scientists, and next 20 years. Astro Pi gives each 
wants to inspire as many students student the opportunity to be an 
as possible to take part in space active participant in space science, 
science with code. rather than just an observer. 
This year, there are two Having a creation of theirs reach 
different missions for students space and do something there is 
——— to enter (see ‘Astro Pi Missions’ profoundly cool.” 
i {hae r . : mm obox). After registering for the Student teams can register for 
Tie Syieean Sg stale a Rhea missions, students will work like the missions at astro-pi.org. 


ASTRO PI MISSIONS 


This year, there are two missions available for Astro Pi. 
Teams must enter by the deadline, but the competition 
then runs into 2018 alongside the mission launch. 


MISSION SPACE LAB rN | 


ANF 
magpi.cc/ 2xikb54 | $10 } 


Registration closes: 29 October 2017 : SPACE TA » 


. S 
- Ascientific mission for young people Mier’ G O > (5 O 


no older than 19 
- Design an experiment, receive free computer 20+ new DrOje cts for YOUr Pi robot car. 


hardware to work with, and write the Python code = aus 


to carry it out ~ 
- Your code could be uploaded to the International ~ 
Space Station and run for three hours (two orbits) 
- Get your results back from space and analyse 
them like a real space scientist 
- The ten best final reports will win special mentions 


and exclusive space-related prizes 


“~~ 
MISSION ZERO any atc ael ee 
. Waal: LEGO MINDSTORMS + RASPBERRY PI 
magpli.cc/2fkznHZ Y on i BS 
Participation closes: 29 November 2017 NS a —. 
- Anon-competitive mission for young people 
no older than 14 
- Write a simple Python program using free 
online tools 
- Provided you adhere to a few rules, your code 
is guaranteed to run in space for 30 seconds 


- Receive a certificate showing the exact time 
when your code was running on the ISS 
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pi-topOS 


The OCR* endorsed pi-topOS 
(Operating system) platform comes 
pre-installed on the 8GB SD card 
shipped with every unit. pi-topOS 
software suite lets you - browse the 
web, - check emails, - create and 
edit Microsoft Office compatible 
files. It includes pi-topCODER and 
comes with the revolutionary 
educational game CEEDuniverse. 


LEDs ere delete litle things If you put too 

mech current through them they ill po 
sometimes quite spectocularty) To lt the 

current going through the LED, you should 
lweys us resistor mm senes with it 
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Quick Launch Notes 


pi-topCODER — 


pi-topCODER is the interface that 
allows you to access worksheets 
and pre-built Raspberry Pi projects. 
It's the easiest way to tinker or 
deliver lessons by providing 
step-by-step guides for computer 
science and STEAM worksheets. 
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pi-top 


WWW.PI-TOP.COM 


pi-topCEED 


The modular all-in-one 
Raspberry Pi powered desktop 


K Adjustable 
Viewing Angles 


14” 
HD Screen 


Loy Modular 
= Components 
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pi-top 


The modular build-it-yourself 
Raspberry Pi powered Laptop 


& 10 Hour 
Battery Life 


13 fe be 
HD Screen 


emg = Modular 
ain Components 


a 
i to Worldwide shipping available in green or grey at www.pi-top.com or our distributors 
Stay up to date with our latest news by following our social media 
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EGO has always inspired people. While it is 
undeniably satisfying to build a set like the 
UCS Millennium Falcon, there is nothing as 


inspiring and creative as a child with a box of LEGO 
pieces. LEGO has the potential to become anything: 
a moon base with rockets and laser cannons, a pirate 
ship, a castle, ora city. 

It’s this imagination and improvisational spirit 
that’s stayed with us as makers, so it’s only 
appropriate that makers often turn to LEGO to bring 
life to their ideas. Grab some LEGO and a Raspberry Pi, 
and let’s build something amazing! 
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LEGO robotics kit 


The EV3 is the starter kit 

for MINDSTORMS robotics 
projects. Combine the pieces 
in different ways to make 
your Own amazing robots. 

It has been used with the 
BrickPi to make wonderful 
creations in the past, and is 
used in some of the projects 
on the following pages. 
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Buy individual LEGO bricks 


Need some specific LEGO pieces? There are nearly 1, 
individual parts to choose from on the LEGO Pick Ag 
website, and prices start at a few pennies. A similar 
service can be found in bricks-and-mortar LEGO stom 
It’s a bit too easy to lose an hour of your life on here 
though, so be careful. 


Connect LEGO MINDSTORMS robotics 
to your Raspberry P1 


Dexter Industries’ BrickPi is an amazing piece of kit. 
It interacts with the popular LEGO MINDSTORMS kits 
to create robotic beasts, controlled via a Raspberry Pi. 
Several projects in this feature use BrickPi. 


LEGO designer 


Want to see whether your design is feasible? Boot 
up Digital Designer and virtually build your next 
LEGO project. You can also use it to make handy, 
step-by-step instructions for your project. 


LEGO wheel adaptor 
for motors 


Want to use LEGO for the 
chassis of your creation? 

For robots and other moving 
objects, that can be tricky. 
This adaptor allows you to 
use micro metal gearmotors 
(magpi.cc/2eYKHZR) 

with LEGO axles to 

create supercharged 

LEGO machines. 
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4 BrickP13 Base Kit 


LEGO MINDSTORMS EV3 


Dexter Industries 
Power Battery Pack 


Rubik’s Cube 


8 x AA batteries 


The BrickPi3, 
with motor and 
sensor cable 
connections 
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he Rubik’s Cube has 

recently begun to make a 

comeback. Solving it takes 
thought, effort, and skill - so why 
not let a robot do it? In this project, 
we take a Raspberry Pi, a BrickPi, 
and a LEGO MINDSTORMS set, and 
build a Rubik’s Cube-solving robot. 
Simply place an unsolved Rubik’s 
Cube in the solver, run the Python 
program, and your Rubik’s Cube 
will be solved! The BrickPi3 takes 
the unsolved Rubik’s Cube, while 
the Raspberry Pi takes a picture 
of each side of the cube using the 
Camera Module. This image is then 
used to solve the fiendish puzzle. 


rotating the cube 


The shuffler 
arm shuffles the 
Rubik's Cube, 


on the y-axis 


Two robot engineers with Dexter 
Industries. Matt builds robots in 
Michigan and John builds robots 
in Dubai. Both enjoy sand dunes, 
mountains, and playing with LEGO. 


Filename: BricKuber. py 
Language: Python 


Building the solver 

This design was inspired by the 
MindCub3r design for LEGO EV3. 

To build the BricKuber, start by 
building the MindCub3r using the 
instructions at mindcuber.com. The 
design features three major moving 
parts: a cradle to hold the Rubik’s 
Cube; a shuffler arm that is used to 
turn the Rubik’s Cube over; anda 
camera arm that holds a Raspberry 
Pi Camera Module over the Rubik’s 
Cube. Two LEGO MINDSTORMS 
motors manipulate the Cube on 


the horizontal and vertical axes. 


Three different 
motors are used 
to manipulate 
and read the 
Rubik's Cube 


(this is the smaller, servo-like 
motor). The camera doesn’t 
move while solving the Cube, 
but you may want to adjust 

its initial location using 

the motors. 


Assemble the BrickP13 
Assemble the case and attach the 
BrickPi3, the Raspberry Pi, the 
Raspberry Pi Camera Module, and 
the battery pack. You can find 


The Camera 
Module reads the 
different colours % 
on the Cube, and ) 

sends the data 


assembly instructions for the to the BrickPi3 to 
BrickPi3 at magpi.cc/2w30wBe. be mapped A ) 
Raspbian for Robots comes with Attach the 

most of the software you need Raspberry Pl 

already set up. We recommend Camera Module 

using an 8GB SD card. Using the LEGO camera 


support, attach the Camera 
Module. The small black lens 


Attach the BrickP13 should fit between the two 

Now add the BrickPi3 to the LEGO beam supports. Secure 

BGO sisseinnioly, Wise ne eG) the Camera Module to the LEGO 

EV3 ‘wings’ to support the supports using electrical tape. 

BrickPi3 level with the BricKuber Make sure that the camera is in 

body. Add batteries to the power the correct position to capture 

pack and attach it to the LEGO ’ the entire Rubik’s Cube. You 

assembly. While programming, | can take atest picture with the 

you can power the BrickPi3 via raspistill command: raspistill 

USB power to the Raspberry Pi. ‘3 = -o cam.jpg. Make sure the 

To move the motors, you will Cubes ceminecsin tine mmealc 

need to supply power with the of the image. =| 

Power Pack. f This step will install all the 

/e libraries you need to run the 

Frep the software See = BrickPi3 on Raspbian. Finally, 

Connect the motors You can use any version of ‘ install all project dependencies: 

to the BrickP13 Raspbian, or Raspbian for ; 

Attach the shuffler motor to Robots (the custom image that 

motor port MD. Attach the comes with the BrickPi3 already 

cradle motor to the MA port on installed). If you are using 

the BrickPi3. Attach the Camera Raspbian, you can install the 

Module motor to the MC port BrickPi3 libraries: 


Y ‘ 


The BricKuber = 


Se a m@ Solve a Rubik's Cube 
Place an unsolved Rubik’s Cube 
in the cradle. Use the command: 


The robot will turn the Cube to 
each face, and the camera will 
take six pictures — one of each 
Side of the Cube. The Raspberry Pi 
will use the pictures to determine 
the Cube’s configuration. The 
Cube configuration will be passed 
to the kociemba Python library to 
find an efficient solution. Finally, | 
the robot will execute the moves | 


yD 


to solve the Rubik’s Cube! : 
tanta 
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BricKP1 


re you tired of robots with three or more 

wheels? We have a solution! Using a pile 

of LEGO and a Raspberry Pi, you can have a 
BrickP13 Base Kit robot wheeling around on two wheels in minutes. Our 


project uses the BrickPi3, which uses precise motor 

controls to create a robot that balances on two wheels. 
LEGO MINDSTORMS EV3 The project uses the LEGO gyroscope to detect whether 

the robot is falling over, and a Python program on 

the Raspberry Pi to control the motors with a PID 


Dexter Industries (proportional-integral-derivative) algorithm. 
Power Battery Pack To get going, simply build the robot, install the 
program, and run! 
Two robot engineers with Dexter 
8 x AA batteries Industries. Matt builds robots in 
Michigan and John builds robots 


: > in Dubai. Both enjoy sand dunes, 
iva, 


mountains, and playing with LEGO. 
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The BrickPi3 

and Raspberry Pi 


€ 
are the brains of Ls 
the robot = _— 


—# 


) ) The LEGO 


motors provide 
m the power to the 
) fm robot's wheels 


The LEGO 
gyroscope sends 
data to the 
Raspberry Pi to 
keep the robot 
balanced - 


a = hi 
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yom 


Filename: BalanceBot.py 
Language: Python 


Assemble the BrickP13 
and the Raspberry Pi 
First, assemble the case, the 
BrickPi3, and the Raspberry 
Pi. You can find assembly 
instructions for the BrickPi3 
} at magpi.cc/2w30wBe. We 

™ recommend using Raspbian for 
) Robots, a version of Raspbian 
that comes with the BrickPi3 
software already installed. You 
can also use your own version 
of Raspbian, and run our install 
script (magpi.cc/2gOjPbT) to 
create the BrickPi3 setup. For 
this project you will also need 
eight AA batteries. 


Build the BalanceBot 
This robot design is very 
Simple and only uses parts that 
come with the MINDSTORMS 
kit. You can find detailed 
IMmstiuenions 1m LEGO Wireiitral 
Designer format, and in HTML, 
on GitHub: magpi.cc/2vZHrQr. 
You will need two EV3 motors 
(with the red hubs and grey 
bodies). Check that the IR 
controller that came with the 
LEGO kit is working, and that 
the batteries are fully charged. 


) 
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Attach the BrickP13 
Add the BrickPi3 to the LEGO 
assembly. The acrylic body is 
attached using the black LEGO 
pins that come with the LEGO 
kit. Place the pins into the 
body of the BrickPi3 first, then 
attach the BrickPi3 to the LEGO 
BalanceBot. Place the batteries 
inside the battery box, and 
connect that to the BrickPi3. 


Connect the motors 
and sensors to the 
Brickr13 

The left and right motors are 
connected to ports MA and MD 
on the BrickPi3. You can find 
Ene jeroume Wellbvells, raelnverd) mvesatc 1) 
the ports on the BrickPi3 case. 
The cables should not cross each 
other. Choose a set of wheels to 
attach to the motors, The code 
that comes with the project is 
designed to work with the black 
low-profile racing wheels that 
come with the LEGO kit, but 
you can adjust the variables in 
the Python program to fit any 
compatible wheel set. 


Connect the sensors 
to the BrickP13 

This project uses the LEGO 
infrared sensor and the LEGO 
eyroscope. The gyroscope will 
read the rate at which the 


The BrickPi3 is 
‘“se4y attached tothe 
robot's body 
using black 
LEGO pins 
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BalanceBot is falling over, and 
adjust the motors. This sensor 

is connected to BrickPi3 sensor 
port 4. This project uses the EV3 
infrared sensor to receive control 
commands: use the infrared 
beacon to command the robot 

to roll forward, backward, and 
turn. The EV3 infrared sensor 

is attached to BrickPi3 sensor 
port 1. Be sure to set the infrared 
channel on the EV3 infrared 
beacon to channel 1. 


Prepare the software 
You can use any version of 
Raspbian, or Raspbian for 
Robots (the custom image that 
comes with the BrickPi3 already 
installed). If you are using 
Raspbian, you can install the 
BrickPi3 libraries: 


This will install all the libraries 
you need to run the BrickPi3 
on Raspbian. 


Run the program 

Power up your BrickPi3 and 
connect it to your Raspberry P1. 
In the command line, enter: 


After starting the program, 
you will be prompted to set 
the robot upright. Balance the 
BalanceBot as well as you can, 
Standing upright, and almost 
balancing on its own. In the 
Terminal, you will be prompted 
to press a button on the IR 
remote control to start the 
balancing process. When you 
press the button, your robot 
should begin to balance on two 
wheels on its own! 
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ant to make a retro 
console with your 
Raspberry Pi? There are 
ASO several tutorials online, but many 
of them use 3D-printed cases. 
Building with LEGO is much 
RetroPie more fun than watching a 3D 
printer whirr away, so here’s how 
to make a NES-like Pi case out 
USB game controller | of LEGO. 
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MAKING WITH LEGO 


>STEP-27 | >STEP-31 


>STEP-29 


Inspiring 


e love seeing your amazing LEGO projects. 
Young or old, it’s a great way to really fire 
~ up your imagination and make something 
™ amazing. Here are some of our favourite builds from 
~~ around the globe — we hope they inspire you to make vA | ¢ ¢ : 
= something spectacular! » ») | ) 


~) 


i } The streets are 


very detailed, 
a“ with Minifigures 
going about their 
awesome lives 
URL 
MAKER 


We’ve featured the Internet of 
LEGO in The MagPi before, but we 
always think it’s worth revisiting. 
It’s an incredible, ongoing project 
that creator Cory Guynn uses to 
teach himself IoT by developing 
a working LEGO city. 

A Raspberry Pi controls the 
city, aided by microcontrollers 
and other Pis hidden in the 
4 different structures. 

) “T grew up playing with LEGO 
bricks and model trains,” Cory 
told us, “which taught me about 
construction and electronics, 
and allowed me to be creative. 
The use of LEGO also allows 

me to represent a city or build 
prototype systems easily. 

Plus, it gives me an excuse to 
buy a bunch of LEGO bricks in 
my thirties.” 
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Tobias Hubner loves to combine machine also has buttons anda 
LEGO and Raspberry Pi. He’s made ___ display built into the model, so 


LEGO 


ARCADE 
MACHINE 


many cases out of LEGO, based that works as a proper tabletop 

on or using official LEGO kits arcade machine! It’s a one-player 

that he’s modified for purpose. device, and Tobias describes it asa 

With some projects, he goes a LEGO Game Boy. You can find out 

little further. how it fits into the Raspberry Pi 
While it works as a case for computer lab at Tobias’s school on 

the Raspberry Pi, this arcade his website: magpi.cc/2wKsepX. 


URL 


Playing with LEGO is fun, but 
what do you do when you need to 
clear up afterwards? Either you 
chuck all the pieces into a box, or 
you build a LEGO robot to sort the of the brick. It determines what 
bricks and tidy them away neatly. colour the brick is, then the 


*, PRESS THE BUTTON .* 
+. FO START THE PI FACTOR. o& 
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David Pride opted for the MeArm robot arm swings around, PR : 
latter, and his robot uses LEGO, picks it up, and puts it in the OJE CTS = 
a Raspberry Pi, and a MeArm to correct container. 
sort individual LEGO bricks by Of course, the time it took to Have you made a LEGO Raspberry Pi project? Has this 
colour. It works by feeding LEGO build and program the arm could feature inspired you to create something incredible? 
bricks down a chute, where the have been used to put the LEGO Send photos to us on Twitter (@TheMagP%1) or via email 
Raspberry Pi then takes a photo away to begin with. (magpi@raspberrypi.org) - wed love to see it! 
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The LEGO WALL-E kit is lovely — 
the simple, mechanical design of 
WALL-E lends itself to translation 
into blocky LEGO. However, 
WALL-E is a robot, and this kit 
doesn’t include any robotics — 

so Tobias added some. 

This WALL-E build uses a 
PicoBorg Reverse (magpi.cc/ 
2wUzmk1) and motors to move 
it around, and it’s all controlled 
via a Wii Remote and a Bluetooth 
dongle on the Raspberry Pi. The 
best part is that because the 
WALL-E kit has a cavity in the 
centre, you can store most of the 
electronics inside him! Bonus. 
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The Raspberry 
Pi is hidden 
away inside 

WALL-E 
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Using a physical LEGO Minecraft 
build, you scan RFID cards to send 
signals to a Raspberry Pi, which 
then builds a specific object in 
Minecraft. This project is a beautiful 
melding of physical and virtual 
worlds, which is something we love. 
It was built for Raspberry Pi’s 
fourth birthday party, and Spencer 
describes it as a demo of how 
children with limited motor skills 
can still play Minecraft. The cards 
allow you to build a house, create 
a waterfall, create a lava version of 
the waterfall, and play a mini game 
involving TNT. 
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There’s a clichéd joke in TV which uses microwaves instead 
shows about smart people. of light, but it is still powerful 
As achild, any smart character enough to burn patterns into 
will have built something wooden boards. He was awarded 
unbelievably advanced for full marks, and the rest of the 
a school science fair. kids voted it as their favourite 
Elijah is a smart schoolchild project. We wonder whether this 
who is currently living this was due to the high quality of 
fantasy. For his science fair, the build, or the fact that Elijah 
he created a LEGO laser gun. is now armed with a working 


More accurately, it’s a maser, laser gun... 


BRICKPI BOOKREADER 2 
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Earlier this year, the great 
folks at Dexter Industries 
(who made the Rubik’s 
Cube solver on page 18 and 
the BalanceBot on page 20) 
created a Pi- powered LEGO 
robot that could read a 
Kindle. It uses the Pi Camera 
Module to take a picture, and 
then uses text-to-speech to 
read the text aloud before 


swiping across the screen UAL MAKER 
| i to turn the page. Re 
) While that was cool, what’s | 

even cooler is to buildarobot MM This isn’ta house full of traps The project 
that works with a real book, » toslow down a set of Minifigure uses sensors to 
and so the Bookreader 2 , burglars, however coolit might be trigger the actions : , | 
was created. It uses a wheel to wallop one with a LEGO brick of automated i = eeu a 
to turn the page, takes a } ona piece of string. Instead, this party-goers in an 
picture, and reads it to you. * house is a recreation of the scene elaborate LEGO setup. 
We wonder if any young kids § where Kevin manages to create We love the reference and 
would like a robot to read the illusion of a partyin his house — the ingenuity behind making 
them a bedtime story while | through an elaborate, Heath it in LEGO, so we feel it definitely 
we watch Black Sails... Robinson setup. deserves a place here! 
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Subscribe in print for 12 
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A free Pi Zero W (the latest model) 


Free Pi Zero W case with three covers 
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A Raspberry Pi 3 is connected to an 
Adafruit PiTFT screen on the back of the 


camera — Abhishek dubs this the CamPi 


The cartridge (aka SnapPi) slots into 
the CamPi, and shows the resulting GIF. 
Each new GIF replaces the previous file 


> The Instagif 
is inspired by 
the Polaroid 
OneStep SX-70 


>» A Pi3 and 
Pi Zero W 
are used 


> Instagif takes 
three-second 
GIFs 


>» The GIF fades 
into view like a 
Polaroid image 


> It took four 
weeks to 
design 
and build 


The 

cartridge looks 
like a Polaroid 
picture, and is 
ejected using a 
rack-and-pinion 
mechanism 


An ad hoc wireless network is 
created on bootup, which allows 
the two Pis to communicate 
without an internet connection 


AITSTEP 


Ever wished your instant camera could cope with moving images? 
Abhishek Singh has the answer! 


efore digital cameras 

became popular, 

photographers would use 
film to capture their images. They’d 
take a set number of shots and send 
their snaps away to be processed, 
but then they’d have to wait days — 
or even weeks — to see the results. 
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Instant cameras were invented 
to speed up this process. Polaroid 
became famous for making 
cameras that could print out a 
paper-based photo in seconds. 

A few shakes, and the image 
would appear as if by magic. 
While instant cameras have fallen 
out of favour with the advent of 
digital cameras, the appeal of the 
COneept eidiuncs: 


Instant update 

Abhishek Singh certainly likes it. 
Motivated by the desire to build 
something physical, and spurred 
on by his love of animated GIFs 
(“my earlier projects have revolved 
around them as well,” he tells 

us), he has harnessed the power 


of the Raspberry Pi and moved 
the instant camera into the 21st 
century. By inserting a cartridge 
with a tiny screen into his cool 
retro-inspired invention, you can 
record a GIF, wait for the cartridge 
to pop out and, after a few seconds, 
watch and enjoy the mini-video. 
What’s more, the device looks 
just like a vintage Polaroid 
Onesrep camel, 

“Something about holding a 
moving image sounded intriguing,” 
Abhishek explains. “It’s instantly 
relatable, and it has the unique and 
exciting interaction of a physical 
image coming out immediately that 
you can hand to a person. I wanted 
to recreate the experience of a 
Polaroid in a new way.” 
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Instant design 

To begin with, Abhishek sketched 
out his plan on paper, before 
turning to Autodesk Fusion 360. 
His design had to take two units 
into account: the camera (dubbed 
CamPi) and the cartridge (SnapPi). 
To produce the camera, he used 

a Raspberry Pi Camera Module, 

an iPhone lens, and an 8GB SD 
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The Pis were trimmed and 
sanded. The Ethernet port anda 
dual USB port were removed from 
the Raspberry Pi 3, so the mounting 
holes could be used for the 
camera chassis. Four circuits were 
produced to manage the wiring and 
distribute power, and Abhishek 
made his own USB cables. Major 
issues included finding a suitable 


For me, 1t was not so much about 
the learning curve being steep as 


about finding creative solutions 


card. The cartridge uses a 2.8-inch 
screen and another 8GB SD card. A 
Raspberry Pi Zero W was fitted into 
the cartridge, and a Raspberry Pi 3 
was used in the camera. 

“T had to think and visualise ways 
of assembling the thing, and look 
at how it would be disassembled if 
I had to troubleshoot something,” 
explains Abhishek. “I needed to 
consider how everything would fit 
together and be placed to minimise 
the size. A lot had to be done to 
conserve space, and I mutilated 
both of the Raspberry Pis I used in 
the project quite a bit, but that’s 
what made using them so great.” 
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way of ejecting the cartridge from 
the camera (Abhishek chose a 
rack-and-pinion mechanism with 
wheels to eliminate friction), and 
solving a wide-angle problem. 
“But I like the community the Pi 
has,” he says. “A solution to the 
problem you are facing is probably 
out there somewhere.” 


Instant success 

It helped that he split the project 
into small, doable chunks. 

“Tt meant I could go through an 
individual process of iteration, 
testing and refinement,” he adds. 
Indeed, once the working pieces 
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fd 


>STEP-03 


were ready, it was simply a case of 
assembling them into the printed 
plastic components that made up 
both the camera and the cartridge. 
Finally, Abhishek could point the 
camera, press the record button, 
and watch as the cartridge popped 
out and the GIF appeared. 

Was it worth it? “The reaction 
has been super- positive,” he says. 
“For me, it was not so much about 
the learning curve being steep as 
about finding creative solutions to 
the problems that arise every step 
of the way.” 


The parts were printed using a Project 7000 SLA printer, 
before being sanded and painted 


Projects 


October 2017 MagPi 


Projects 


Pl CAMERA 


> The build 
details are at 
magpi.cc/ 
2xhKuZq 


> A BerryGPS- 


IMU provides 
geotag data 


>» AGPS fix takes 
10-15 minutes 


>» The main 
software is a 
Bash script 


> The data can 
be used to map 
your route 


Rather than keeping it under his hat, Mark Williams 
reveals how he made his GPS-equipped camera cap 


ho needs Google Glass 

to produce a first-person 

visual record of their 
day, when you can make a DIY 
camera cap? That’s just what 
Mark Williams did, using an old 
Nike baseball cap, a Raspberry 
Pi Zero, and a Camera Module. 
Not only that, but he’s added 
one of his own BerryGPS-IMU 
boards, created with his 
colleagues at Ozzmaker. 

The Berm GPs IMU obtams Ges 

coordinates to geotag the photos 
taken, as well as logging the 


altitude (with a pressure sensor) 
and ‘attitude’ — pitch, yaw, and roll 
— of the camera, to enable images 
to be subsequently corrected to 
appear perfectly horizontal. 

“T saw an old article about 
recording GPS, pitch and roll 
angles of photos and I thought 
the Pi Zero with a BerryGPS-IMU 
could pull this off nicely,” explains 
Mark. “Originally I was going to 
place it in the top pocket of a shirt. 
However, placing it in a cap would 
give you a wider range to take 
photos in: just look and shoot!” 


Building and coding 
While embedding the Pi Zero 
and BerryGPS-IMU in the cap 
was very quick and easy, it took 
Mark about a week to come up 
with the main Bash script that 
calls Python code and other tools 
to perform various functions. 
“My thinking was that I already 
have Python code to track GPS 
and read the IMU. Raspistill was 
used to take photos and Exiftool 
was used to edit EXIF data in the 
photos. I just needed to put it 

all together.” 


The camera device is 


| mounted ona regular 
Nike baseball cap 


The BerryGPS-IMU 
provides GPS coordinates 


and other data 


A basic camera mount 
was made from 3mm 
laser-cut acrylic 
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Fix pin and LED 


>STEP-01 


Customise a cap 


>STEP-02 
Connect GPS fix pin 


>STEP-03 


Power it up 


The BerryGPS-IMU is placed on top of the 
cap's visor, with the Pi Zero underneath, 
connected via holes. A laser-cut acrylic 


To detect whether a satellite fix has been 
obtained by the BerryGPS-IMU board, its 
fix pin must be connected to a GPIO pin 


The Camera Cap is powered bya 
small 3.6 V LiPo battery, connected 
to the Pi via an Adafruit PowerBoost 


mount holds the Camera Module. on the Raspberry Pi. 


Mark informs us that obtaining 
a GPS fix typically takes 10 to 
15 minutes. “As long as the 
BerryGPS-IMU module has 
access to the sky, no antenna 
is needed.” He has tested the 


fix, it performed well. Most of the 
issues | had were with the script 
not starting up correctly when 
the Raspberry Pi was powered 

on. I also had to fiddle with 

the settings for taking images. 


Once I had a GPS fix, 1t performed 
well. Most of the issues I had 
were with the script 


Pi Camera Cap outside on a few 
occasions, including a stroll 
around Sydney Harbour, taking 
pictures of the famous bridge and 
opera house. “Once I had a GPS 


At first I tried to take a photo 
every five seconds by removing 
the delay from raspistill, but 
this resulted in the Pi camera 
not being able to focus.” 


Software such as GeoSetter (Windows) can be used to show a map Location, 
and even the camera direction, for each photo taken 
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1000. It delivers 1.5 hours of use. 


2 Mark 
wore the cap on 
a stroll around 
Sydney Harbour, 
taking photos of 
landmarks such as 
the famous ‘coat 
hanger’ bridge 


Photographic record 
The cap is powered by a small 
2.6) Fib@baricn  eommeercd 
to the Pi Zero via an Adafruit 
PowerBoost 1000, it can power 
the device for up to 1.5 hours. 
By default, the camera is set to 
take a photo every two minutes, 
but this can easily be altered. “I 
would say time-lapse is possible; 
the lowest interval I had where 
the image quality was still good 
was 20 seconds.” There’s also the 
possibility of shooting video. 
Mark says he has received some 
strange stares while wearing 
the cap in public. “I think the 
outward-facing Pi camera and the 
size of its PCB makes it obvious 
something strange is going on 
with my cap.” As for needing to 
visit the bathroom, he advises it’s 
“best just to take the cap off!” 
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Looking to brighten a dark 
bedroom, Roberto Tyley decided 

to cast fresh light on the idea of a 
motion-sensing illuminated mirror 


n reflection, he could have 


This shelf of electronics 


> It took nine 
months to build 


» The laser 
was £139 and 
the project 
cost £250 


» Roberto used 
an eyeball-safe, 
low-power 
Class | laser 


> A Bluefruit EZ- 
Key acts as the 
on/off switch 


> Find the Python 
code at 
magpi.cc/ 
2wURUBy 


effortlessly slides into the 


just bought a lamp. But 

after Roberto Tyley stood 
on one too many of his children’s 
toys in the dark corners of his 
bedroom, and decided it was time 
for some additional light, he was 
hit by a flash of inspiration. 

What better way of illuminating 
the room, he mused, than a full- 
length portrait mirror that would 
shine brightly whenever anyone 
wandered by? One with individually 
controllable LED lighting that 
would directly respond whenever 
someone posed in front of it, 
perhaps? As light-bulb moments 
go, he admits it was certainly high 
on the wacky scale. 

But Roberto saw the potential for 
both practicality and fun. “The idea 
was to have a mirror that would 
know if my children were waving 
their hands around,” he explains. 
“T wanted the lights to move and 
sparkle around their fingers as 
they did so.” 


unit, connecting via a Multi- 
Beam XLE power connector 


Roberto didn't want to use 
an obtrusive always-on 
video camera, so he used a 
laser rangefinder instead 


Pi-powered 
Roberto’s first decision was to put 
a Raspberry Pi at the heart of the use a simple wiring system, 
with four wires controlling 
build. He had only ever used the the whole strip 
computer once before, to create 
a video demonstrating the speed 
of a tool he’d written to clean Git 


The Adafruit DotStar LEDs 
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Sree 


My children love it, and they 
show it off to their friends 


when they come round 


repositories. He liked the fact that 
the Pi was a fully specced Linux 
platform. “It meant I could use the 
tools and languages I was familiar 
with,” he says. 

His next step was to research the 
best lighting, and he eventually 
chose Adafruit’s DotStar Warm 
White LED strips. “They are more 
expensive than simple strips, but 
they use a pretty straightforward 
Wiring system,” Roberto explains. 
“Adafruit also supplies a nice 
Python library to control the strip 
from the Pi.” 


Motion sensing 

From there, he looked for a way of 
detecting the presence of a person, 
before hitting on the idea of a laser 
rangefinder. “It occurred to me 
that if I had a laser rangefinder 
pointing straight down from the 
top to the bottom of the mirror, in 
the same axis as the LEDs, it could 
sense how high up anything was,” 
he continues. 

This would allow the LEDs to 
light up to the height of a person, 
or work out if they were stretching 
their arm up, and illuminate 
further. “I decided to use the 
LIDAR-Lite rangefinder, which is 
a pretty cool but pricey sensor that 
encodes digital fingerprints into 
the bursts of laser light it sends 
out,” he tell us. “This means it 
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can uniquely identify the pulses of 
light that bounce back, so it’s not 
confused by secondary reflections.” 

To tie everything together, 
Roberto created a simple program 
in Python: “The code polls the laser 
rangefinder to work out if there is 
an object closer to the top of the 
mirror than the mirror base. If there 
is, it increments the brightness in 
an array that tracks how bright all 
the LEDs should be.” But it wasn’t 
entirely straightforward. Creating 
the body of the mirror proved a 
daunting task. 


Learning by doing 
“Before I started, I had zero 
woodwork skills — I’d been terrible 
at it at school,” Roberto admits. He 
watched several YouTube videos 
about making mirror frames (“the 
opposite sides really need to be 
the same length,” he laughs) and 
he also ended up buying all kinds 
of powerful tools to get really 
accurate mitre joints. 

Still, it was worth it. During the 
erand unveiling, accompanied 
by the sounds of 2001: A Space 
Odyssey, he watched the delight 
on his children’s faces. “It had 
become an almost embarrassing 
addiction,” he says of the process. 
“But my children love it, and they 
show it off to their friends when 
they come round.” 


>STEP-0O1 

The handy compartment 

The electronic components sit inside this removable, 
easily accessible shelf. It includes a Raspberry Pi, 
backplane connector, speaker, laser rangefinder, AC 
power in, and power supply. The decorative brass 
grille provides ventilation. 


>STEP-02 

Fixing the lights 

The LEDs fit behind the mirror’s frame. “Problem is, 
they have a tiny computer running in each pixel, so 
extra power taps are needed every metre or so to 
keep the voltage level high,” says Roberto. 


oe 8 ; a 
oe" ae: 5 8, a ge 


>STEP-03 

Connecting everything up 

The key I/O components use four-wire connections: |?C 
for the LIDAR-Lite and SPI for the DotStar. Thankfully, 
the Pi can handle both. Roberto soldered the 
connections to an easily attachable Perma-Proto HAT. 
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Rotary knobs control 
parameters such as attack, 
release, modulation, 
detune, and delay 


notes and menus 


Two push-buttons are 
used to access and cycle 
through menu screens 


FIVi TOUCH SYNTH 


Frustrated by unreliable iPad music apps, Toby Hendricks built 
a homemade touchscreen synth based on a Raspberry Pi Zero 


> It took a month 
to build and 
program 


> Aresistive 
overlay is used 
(magpi.cc/ 


2gJSZIb) 


>» Sounds can be 
stored in eight 
patch presets 


» LEDs are used 
to display notes 
and menus 


» ATeensy 
3.6 handles 
controls and 
audio output 


ot long after impressing 
us with his Raspberry 
Pi Looper ‘synth drum 
thing’ (magpi.cc/2xZTAXR), 
Toby Hendricks (also known as 
Otem Rellik) is back again with 
another Pi-based musical device. 
This time he has constructed 
a touchscreen synthesiser 
that offers a wide variety of 
stunning sounds, modified using 
a combination of rotary knobs 
and touchscreen control. 
“Tt went through several 
iterations before I settled on 
the final design,” Toby tells us. 
“The original idea was to have 
two touchscreens for two-voice 
polyphony, but that ended up being 
a bit too large, so | went with one.” 
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Zero debut 
While a Teensy 3.6 board is used 
to handle the control data, all the 
audio — created using a combination 
of FM and subtractive synthesis — 
is processed in Pure Data on a Pi 
Zero. “This was my first project 
using the Zero,” says Toby. “I 
just wanted to see if] could runa 
somewhat simple Pure Data patch 
on a Zero without any audio glitches 
(and it turns out I could). Size was 
definitely a factor: I wanted to make 
a really slim, sleek instrument.” 
Toby says the Pure Data 
programming language is easy to 
use. “Once you learn the basics, 
you can do so much with audio and 
MIDI. It’s a visual programming 
language, so instead of writing 


code line by line, you create objects 
and start connecting patch cables. 
It’s great if you are coming from 

a non-technical perspective 
because everything is so easy 

to understand visually.” 


Touch the music 

While the synth’s rotary knobs 
are used to control aspects such 
as attack, release, frequency 
modulation, detune, and delay, 
the main input interface while 
playing and creating new sounds is 
the touchscreen overlay. Columns 
of RGB LEDs placed beneath it 
depict eight notes (the scale of 

A minor), while the position of 
the player’s finger modifies the 
sound produced. 
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Rather than displaying 
information on a regular 
touchscreen, Toby opted to use LEDs 
for everything, including menus. 
“It’s a bit more archaic and cryptic. 

I like to make instruments that you 
really have to learn to use, and aren’t 
immediately super-accessible. Sort 
of like the old hand-held video 
games I grew up with.” 

One drawback is that the 
resistive overlay can only handle 
one touch ata time, although a 
workaround involves sustaining 
notes. “I added the sustain feature 
close to the end of the project 
because I wanted polyphony. The 
synth just sounds so massive when 
you play it polyphonically. Perhaps 
in the future I’1l upgrade the screen 
to allow multitouch.” 


Toby is pleased with the case, 
crafted using his new CNC machine: 
“| think all my future projects will have 
wooden cases" 


Live project 

Toby has already used the FM 

Touch Synth in live performances. 

“Tt’s working out great! I’ve 

been doing a lot of ambient jam 

sessions with it, turning the delay 

way up and feeding into my Pi 

Looper. It’s been a lot of fun.” 
Toby would really like to make 

the synth available commercially, 

which is why he hasn’t released 

the code yet, but he’s already 

working on another Pi Zero 

project: “a looper in which 

you can manipulate the pitch 

and speed of the loop in four 

different slots.” 


gba 
iid fe 


a 


raspberrypi.org/magpi 


IY 


J 


= 


— 


The menus are a 
bit hard to fathom 


at first sight, but 
they include 
presets, sound 
parameters, 
vertical position 
effects, anda 
voice level mixer 
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In spite of its size, the Raspberry Pi makes a powerful 
image-editing machine 
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PDF is a great format for sending and sharing documents, but you can do an 
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Tutorial DY Wartuc: 


~ MIKE COOK 


Veteran magazine author from the old 

_ days and writer of the Body Build series. 
Co-author of Raspberry Pi for Dummies, 
Raspberry Pi Projects, and Raspberry Pi 
Projects for Dummies. 

magpi.cc /259aT3X 
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t is time for our annual Halloween project, and spooky particles that are emitted when they collide at 

publishing this at the end of September gives speed. Just like many of the world’s colliders, it works 

you plenty of time to get it working for your by sending Head one way round a ring of accelerators, 
Halloween party. This time, it’s agame with Headthe and Ron inthe opposite direction. All you have to do is 
Skull and Ron the Pumpkin, in a race to detect the to press the foot switch at the instant they pass each 


Connections to the Pi's GPIO ports 


Make a spooky 
reaction game for 
your Halloween party 


12 x mini skull 
string lights 


12 x mini pumpkin 
string lights 


One red/green 
common cathode 
LED 


Foot-operated 
switch and jack 
socket 


GPIO connector 


Resistors 
and wire 


Strip pine and 
MDF sheet 


M3 nuts 
and bolts 


The green LED is 
the speed indicator 


The illuminated 

skull indicates | ‘rene The illuminated pumpkin 
the Head j indicates the Ron 

stream position — stream position 
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The two strings of LEDs we used for this project 


other, once they have accelerated up to full speed. 
You know when they are up to speed because a speed- 
monitoring LED at the centre of the collider changes 
from red to green. 


The circuit 

We used two very cheap sets of string lights, obtained 
from our local pound shop, as shown in Figure 1. 
Surprisingly, they each cost a pound. The LEDs are 
wired in parallel, and utilise the internal resistance 
of the batteries to keep the LED current in check. In 
this project, we are going to control them from the 
GPIO ports of the Raspberry Pi, and provide a real 
resistor in series with each LED. This project uses all 
but one of the GPIO pins on the connector, including 
the ?C HAT identification pins. The LEDs themselves 
are rather interesting, as they are designed with a 
300-degree viewing angle. They use a cone-shaped 
indent which acts as a reflecting surface, spreading 
the light all round, as shown in Figure 2. 

The schematic for our game is shown in Figure 3 
(overleaf), and is pretty straightforward, using LEDs 
and a switch. The common cathode tri-colour LED 
is simply ared and a green LED in one package. 

As there is no data sheet for the string light LEDs, 
we had to experiment to find out which resistor 
values produced which levels of current. The 
forward voltage of the LEDs is close to the 3V3 of 
the GPIO pins, so we only need low-value resistors 
to run the white and orange LEDs at 5 mA and 
4,.mA respectively. 


MN 


Reflecting surface 
Cone shaped indent 


Light rays Light rays 


LED chip 


A 360-degree LED Wires 


At acursory glance, you might think that we are 
overloading the current capability of the GPIO pins 
(51 mA in total), but the project will only illuminate 
one LED at a time for the Head and Ron groups, plus 
one of the two speed LEDs. We could have opted for 
full buffering and driven the LEDs at 5 V, along with 
a much higher current, but in the end we chose the 
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>STEP-0O1 
Making the board 30° 


Take a piece of 6 mm thick MDF, 330x330 mm 
in size. Drill a hole in the centre and mark 

two circles of 150 mm and 120 mm radius, 
centred on the same point. We made a strip 
of Perspex with three holes, and used a 
screw in the centre and a pencil in each hole 


to draw the circles. Then we then used a 
30-degree set square and a ruler to mark the 
position of the mounting holes, and drilled 
them with a 3 mm drill bit. Next, we glued on 
20 mm stripboard to make a tray, painted it 
all with a flat black paint, and filed a slot on 
the right-hand side for the foot switch cable. 4 

Finally, we filed a slot on the back edge, near 

position 10, for the 40-way ribbon cable. Inner ring - Ron's positions 120 mm radius 


Raspberry Pi GPIO Pins Schematic for the 
Head ‘n Ron game 
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Foot switch 
GPIO 2 


Red Green 
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Speed LED 


Ron LEDs 
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Figure 4 Hit your foot switch now! simplest and cheapest option. If you want to develop 
other games with more LEDs, we would recommend 
using a buffer, such as the ULN2003A. 

The construction of the project is shown in the 
steps, and takes a bit longer than you might think. 


The game 
The game takes its inspiration from other forms of 
large colliders. The two streams go round in opposite 
directions. When they meet, they are diverted into 
the same path, and they collide. You have a foot 
Switch to press when the two streams are at the 
same point. 

Watch out — with 12 positions per circle, and 
moving at the same speed, there may never 
be a time when the two streams are at the same 
point. The trick is to make them move at different 
rates. What’s more, it takes time for the streams to 
accelerate to a colliding speed, and this is signalled 
when the central LED turns from red to green. If you 
press the foot switch at the right time, as shown 
in Figure 4, the screech of fundamental spooky 
particles is released, and the collider starts again 
— only this time it goes faster! Once you miss, the 
round ends, and you’|l be given a score based on the 
number of correct hits. 


>STEP-04 
Wiring it up 


Mark the positions (Head 1-12 and Ron 1-12) on the underside 
with a pencil so you can identify the LEDs. Wire the GPIO 
connectors to the appropriate LEDs through the appropriate 
resistors. We used surface-mount resistors on the back of the 
stripboard, mainly because we had them in stock at the right 
value - there is no advantage to using surface-mount resistors 
over through-hole resistors here. Don't forget to add the jack 
for the foot pedal as well - it doesn't matter which way around 
cae you attach it to GPIO 2. Use the threaded pillars to attach the 
AES EEE ee ee eg Se ene stripboard to the underside of the game, and the ribbon cable 
(ge SSTEp- 03 to attach the game to the Raspberry Pi. Do not underestimate 
the length of time it will take to complete this step — it took us 
Mounting the LED shells over four hours, including using heat-shrink sleeving to extend 


the LED wires. 
Separate the two halves of the plastic skull 


and pumpkin LED covers. Drill a 3 mm hole in 
the base of the back half of each cover, and 
attach each one to the top of the box using 

a 10mm M3 screw and nut. For positions 9 
and 11, use a 10 mm threaded pillar instead 
of a nut, as these will act as a mounting for 
the stripboard. Drill a 5 mm hole in front of 
each half shell, as close to it as you can, and 
insert an LED of the appropriate colour. Fix 
the LEDs in place with hot-melt glue from the 
underside of the board. Finally, cut holes in 
the bases of the remaining front-half covers 
to fit around the LEDs, and clip the front and 
back of each cover back together. 


Software head _n_ron npy 
The software uses the Pygame framework to | 

produce the sound. Make a directory called Sounds 
in the same directory as the program, and copy 

into it the files Screech.wav and Spiral.wav from 
the directory /usr/share/scratch/Media/Sounds/ 
Electronic. Most of the action is controlled by the 
playRound function, which contains a state machine 
that decides which (if any) of the streams to move, 
based on the elapsed time clock. It returns a true or 
false signal to indicate whether or not the round 
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EBREGG® 
| 


. import pygame,time, random 
| im import RPi.GPIO as io DOWNLOAD: 
| 003. magpi.cc/1NqJjmV 
004. pygame.init() 
Q05. pygame.mixer.quit() 
Q06. pygame.mixer. init(frequency=22050, 
Size=-16, channels=2, buffer=512) hace cut Mike 


007. random.seed ( ) Bakery videos at: 
008. magpi.cc/1NqJnTz 


| @09. def : 

Semen Val ier er ker val uae eiperval | 010. Se rightSpeed, speedThreshold, hInterval, 
control the speed of each stream, and the variable | aIntenval 
speedThreshold determines when they reach a 
speed suitable for collision. Altering the speedInc | if ee ue ead 9 F — ider game") 
variable controls how quickly the streams accelerate | 942. print("( C to quit") 
up to speed. | 914. init() 

. : Q@15. while 1: 
Taking it further ~ - & 
You can adjust the variable controlling the final | 017. countR = random.randint(Q,11) 
speed of the game, but at its fastest it is quite tricky. | 18. countH = random. randint(@,11) 
The initial slow start ensures that everyone can | @19. score = @ 
manage at least one hit. You could add extra sound | @20. hInterval = 2.0 ; rInterval = 
effects, such aclunky whine as the acceleratorramps | @21. speedThreshold = 


up, or a spooky cackle if you miss. | @22. io.output(speed[],1) 


023. 
024. 
925. 
626. 
027. 
628. 
929. 
030. 
931. 
032. 


033. 


034. 
935. 
036. 
037. 
038. 
939. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 
049. 
050. 
951. 
052. 
053. 
054. 
055. 
056. 
057. 
058. 
959. 
060. 
061. 
062. 
063. 
064. 
065. 
066. 
067. 
068. 
069. 
070. 
071. 
072. 
073. 
074. 
075. 
076. 
077. 
078. 
679. 


THE LARGE HEAD ‘N RON COLLIDER 


io.output(speed[1],0) 

rightSpeed = False 

while playRound(): # keep going until you miss 
pass 

miss.play() 

print("Score",score) 

a = input("Press return to play again") 


def playRound(): 
global countH, countR, lastRon, lastHead, overlap, 
score 
global rightSpeed, riInterval, hInterval, 
speedThreshold 
done = False 
if time.time() - lastRon > riInterval: 
countR = moveR(countR) 
lastRon = time.time() 
if countR == countH: 
i ioe oS) ; 
overlap = True 


if not rightSpeed and rInterval > speedInc: 
rInterval -= speedInc 
hInterval -= speedInc 
if rInterval < speedThreshold: 
io.output(speed[@],0) 
io.output(speed[1],1) 
rightSpeed = True 
if time.time() - lastHead > hInterval: 
countH = moveH(countH) 
lastHead = time.time() 
if countR == countH: 
lap akeycalla\ol el), 1) 
overlap = True 


if countR != countH and overlap: # have they passed 
overlap = False 


if TO an pu (2 i =—0 \ 
if overlap and rightSpeed: 
print( "bang" ) 
bang.play() 
while pygame.mixer.get busy(): 
pass 
overlap = False 
# make go faster 
if speedThreshold > speedInc: 


speedThreshold -= 0.1 #change colliding speed 


hInterval = 2.0 ; rInterval = 1.5 
score +=1 
io.output(speed[@],1) 
io.output(speed[1],0) 
rightSpeed = False 
time.sleep(0.8) 
else: 

if not rightSpeed: 
print("not going fast enough") 

else: 
print("not in the right position") 
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080. done = True 

081. return not done 

082. 

Q@83. def moveH(count): 

Q84. i0o0.output(heads[ count], 2@) 

085. count += 1 

Q@86. if count > 11: 

087. count = @ 

088. io.output(heads[count],1) 

089. return count 

g90. 

@91. def moveR(count): 

Q@92. io.output(rons[ count ],0) 

g93. count -= 1 

Q94. if count < @: 

g95. count = 11 

Q@96. io.output(rons[ count ],1) 

097. return count 

g98. 

@99. def init(): 

10@. global heads, rons, speed, hInterval, rInterval 

101. global countH, countR, lastRon, lastHead, overlap 

102. global rightSpeed, speedInc, speedThreshold, bang, 
miss 

103. countH = 4 ; countR = @ 

104. lastRon = time.time() 

105.  lastHead = time.time() 

106. overlap = False ; rightSpeed = False 

107. heads = [14,15,18,23,24,25,8,7,12,16, 20,21] 

108. rons = [3,4,17,27,22,10,9,11,5,6,13,19] 

109. speed = [0,1] #speed LED 

110. hinterval = 2.0 ; rInterval = 1.5 

111. speedinc = @.1 

112. | speedThreshold = 1.0 

113. io.setwarnings(False) 

114. io.setmode(io.BCM) 

115. io.setup(heads, io.OUT) 

116. io.setup(rons, io.OUT) 

117. io.setup(speed, io.OUT) 

118. io.setup(2, io.IN) # foot switch 

119. bang = pygame.mixer.Sound("sounds/Screech.wav" ) 

120. miss = pygame.mixer.Sound("sounds/Spiral.wav" ) 

121. 

122. def clr(): 

123. for led in range(@,12): 

124. io.output (heads[led],®@) 

125. io.output(rons[led],0) 

126. io.output(speed[@],0) 

127. io.output(speed[1],0) 

128. 

129. # Main program logic: 

130. if _name__ == _"_ main_': 

el NS ae 

£32) main() 

133. finally: 

134. clr() 

135. pygame.mixer.quit() 

136. pygame.quit() # close pygame 
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Tutorial 


MAKE A 


PODCASI| 
MACHINE 


Your Raspberry Pi is a perfect pocket-sized PC for podcasting — we’ll show 
you how to record, edit and publish your own online radio programme 


Ithough it’s a little short on memory when sample rate of 44.1 kHz. This is Audacity’s default 
Amicrophone it comes to heavy-duty multi-track audio setting, so you won't need to change anything. 
encak editing, a passively cooled Pi runs completely 
nee silently, which makes it easy to create clean voice >STEP-O1 
headphones y) y 
audacity recordings with minimal background noise. Get connected 
These instructions will work perfectly on any Connect your speakers and microphone to your 
poodie account Debian-based Linux distro, such as Raspbian or Pi. You can get away with using your TV’s built-in 
Internet Ubuntu MATE. As you’re going to be recording raw speakers via an HDMI connection, but connecting 
oer PCM audio, we recommend using a reasonably large headphones to the 3.5 mm analogue port makes for 
microSD card if you plan to keep previous recordings a more private editing experience. 
for posterity. A USB gaming headset with a built-in microphone 
Although we’ll be exporting the audio files at a will do in a pinch, but we recommend a USB condenser 


lower quality, we recommend recording ataminimum mic for better quality voice recording. We’re fans 


OPTIMISE 
ANALOGUE 
AUDIO 
QUALITY 


The Pi's 

headphone You can select external audio 
devices using Audacity’'s 

port an Pi pull-down menus 

unwante 

background 

noise. To 


minimise this, Audacity defaults to a sample 
: rate of 44.1 kHz, which is fine 

set your mixer for most recording projects, 

volume to including this one 

100 percent 


and use a 
good-quality 
power supply. 
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of the Blue Microphones Yeti, but you can get good 
budget options such as the Blue Snowball iCE and 
Samson Go Mic for less than £50. 


>STEP-02 

Record your podcast 

Install Audacity by opening a Terminal window and 
typing sudo apt-install audacity. Open the 
program, and make sure it is using the correct audio 
input and output devices by checking the device 
pull-downs on the taskbar, or by opening Preferences 
from the Edit menu. 

Before you start recording, we recommend 
writing a script or prompts to work from. If you 
stumble, just pause, go back a few sentences and 
Start again — you can cut out the error later. For 
easier editing and processing later, it is often more 
convenient to break longer recordings into 10- or 
15-minute chunks. 


>STEP-03 
Edit and process 
Once you’ve finished recording, it’s time to edit 
out any errors and use a few effects to improve the 
recording’s quality. 

To reduce background noise such as computer 
or fan hum, highlight a few seconds of audio with 
only background noise. Select Noise Reduction from 
the Effect menu and select Get Noise Profile. Then 
select your entire track, open Noise Reduction again, 
and hit OK. 

To balance and amplify your recording if it’s 
too quiet, select the entire track and apply the 
Normalize effect using its default settings. Finally, 
go to File > Export Audio, and encode your recordings 
as MP3s — we recommend 96kbps joint stereo 
for voice. 


kb hiy Feeds = 


WEI) 


My Feeds dot dash dot dot dot dot Google feedburner 
dot dot dot 


et Witehoona tho Feed Fanner, RedéindAlackPiel si gqmail com 


Odsence for bem 


(5 baying qendbye te 

the AdSense for Feeds 

blog TW Ro12 
Looking for feeds you used to have at feedburnercom? as 
J Wour vtats, right 
Claim your feode nay =! away VOR TOLO 
GS Enabling eetial 
shannag wth | 
Feed Flare 472506 | 


- GF - 


Burn a feed right this instant. Type your bing or feed address here: 


- FeedBurner Status 
Gin ope! Next »| o 


Neng eac qo noc hs, Bao. Tr 
ha Baily stats between 
May Sth end May 3th 
—_ : were miing, hut ane 
new available W122016 
Monitor thé health of your feed by subscribing to FeedBulletin. 
Fredfulein i ou way ol commun 2 PeedMedic alesis aru 
eccenonal “oficial mereages trom the Feedburner wee: 
Nipclteed:. foediurnee oon wee 1 FTAs sod eS 
© periand cody aed Perici pee 


S Pood and itam ctate 
for February Dod and 
ard are delayed 
(hime) Sevodie 


Above Feedburner turns your blog into a podcast feed that will 
work with popular directories such as iTunes and Stitcher 
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PODCAST MACHINE 


Deemer | soe 
ed A ies Fats Pro ee oo 6222 FY =- = = 
— — + f- = ert] 2° *- meg) f-Hiad New 
teens pone Shs pean peep be applets BG a 
= 
> as Above Use 
STEP-04 sees 
Create your blog Enclosure Links 
; : field to post 
Go to drive.google.com and log in to the Google your MP3 files 
account you want to use. If you don’t already have a once you've 
uploaded them 


Google account, you can sign up for one on this page. 

Go to blogger.com and sign in using your Google 
account. Create a Blogger or Google+ account. When 
the main Blogger interface loads, hit the Create New 
Blog button. Pick a name, custom blogspot URL, 
and theme. 

To allow MP3 embedding, go to Settings > Other 
and switch the Enable Title Links and Enclosure Links 
settings to Yes. Now select Save Settings at the top 
right-hand corner of the screen. 


>STEP-05 

Upload your podcast 

In Google Drive, create an appropriately named folder. 

Set the folder’s privacy to allow ‘anyone with the link’ 

to view the files in it. Upload your first MP3, right- 

click on it and select Get Shareable Link. Copy the link. 
Return to Blogger and hit the New Post button. Give 

your podcast an appropriate title and description, 

using the Title field and Post Body respectively. In the 

Post Settings box on the right, select Links. Paste your 

MpP3’s URL into the Enclosure Links field and give it 

a MIME type of audio/mpeg3. Hit Publish, and we're 

ready to go live. 


>STEP-06 

Launch your media empire 

Go to feedburner.com and sign in with your 

Google account. Paste your blog’s main URL 
(yourcustomurl.blogspot.co.uk) into the Burn A Feed 
box, tick ‘Iam a podcaster’, and click Next. 

Select the feed you want to use — we prefer the 
longer-established RSS option, but Atom works too. 
Feedburner will ask you to confirm the title and the 
address you want to use. 

Your podcast is ready for subscribers, but you should 
click Next to fill in extra information for the iTunes 
podcast directory. Feedburner tells you what you need, 
including an image and a more detailed description, 
and can even provide listener stats. 


to Google Drive 


GET LISTED 


For extra 
exposure, list 
your podcast 
on online 
directories. 


The most 
important is 
iTunes, which 


you can you 
join at 
magpi.cc/ 
2x233hl 
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Tutorial 


SIMULATE CIRCUITS 
WITH XYCE ON PI 


Compile Xyce, an open-source state-of-the-art circuit simulator, on a Raspberry Pi 


Latest version 
of Raspberry 


Pi Desktop/ 
Raspbian 


16GB SD card 
(or preferably 
a larger solid- 
state drive or 

hard drive) 


Below Input [V(101)] 
and output [V(VOUT)] 
of the operational 
amplifier inverter 
circuit. Note 
transient at start 

due to poor initial 
condition assumption 


amplitued fy) 
a 


here are many circuit simulators, such as 
SPICE, TINA or DoCircuits, available for use 

in designing circuits. However, most of them 
are either limited-use free versions or academic 
programs. Xyce is an open-source and fully functional 
circuit simulator developed by Sandia National 
Laboratories (supported by the US Department of 
Energy), that you can compile on a Raspberry Pi. 

A quick warning: there are challenges associated 
with compiling using the limited memory on a Pi, and 
this project will take about a half day to complete, 
even on a Raspberry Pi3. 


System preparation 

Start by updating and upgrading your distribution. 
Xyce does not compile on systems with only 1GB of 
memory. The minimum recommended is 4GB, so next 
we must expand the swap file size to accommodate 
the compilation: 


sudo nano /etc/dphys-swapfile 


OP27 arquit 


— 101) 
—— WV) 


tan | a) 
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Change the CONF_SWAPSIZE from 100 to 2048 (the 
maximum possible), save, and exit. Next make the 
change effective: 


sudo dphys-swapfile setup 


When you have compiled the code, you can reset the 
swap file to 100Mb if you like. 
Install the required utilities for the compilation: 


sudo apt-get install gfortran cmake bison 
flex libsuitesparse-dev libtool 


Install Fourier transform libraries 
Next, install the Fortran fast Fourier transform 
libraries. Use the Chrome browser to do all the 
downloading. Go to magpi.cc/2vI69FW and get 

the 3.3.6 release via tar.gz — this will put the file in 
your Downloads folder. Navigate to the Downloads 
directory in a Terminal window and unzip and extract 
the file: 


cd ~/Downloads 
tar xzf fftw-3.3.6-pl2.tar.gz 


Now build and install fftw: 


cd fftw3-3.3.6-pl2 
./configure 

make 

sudo make install 


Install Trilinos libraries 

Next, we install the Trilinos libraries, a very powerful 
set of serial and parallel solvers. Go to trilinos.org 
and navigate to Download > Previous Releases. In the 
Pages section on the right-hand side of the screen, 
find the version 12.6.3 link. You want this version 
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SIMULATE CIRCUITS WITH XYCE ON PI 


/ 


PARALLEL ELECTRONIC SIMULATOR 


KL 
C 


for Xyce 6.7, as later versions aren’t guaranteed to 
work with Xyce. Trilinos is free, but you will need to 
sign up to access the files. Download and unzip the 
Trilinos files: 


cd ~/Downloads 
tar -xzf trilinos-12.6.3-Source.tar.gz 


The last command places the source code in 
~/Downloads/trilinos-12.6.3-Source, but we want 
to do an ‘out of source build’, so create a directory 
to do this: 


cd ~ 
mkdir Trilinos12.6 
cd Trilinosi2.6 


Xyce only uses some of Trilinos, and there is a 
suggested reconfigure file on their build page. You 
can find a modified version at magpi.cc/2vI6loE, 
called reconfigure. The SRCDIR line assumes you 
have followed the instructions above. Make sure that 
reconfigure is executable, run it, and then build the 
code. The make command will take about an hour and 
a half to complete. 


chmod u+x reconfigure 
./reconfigure 

make 

sudo make install 


Build Xyce 


Download Xyce from magpi.cc/2vl1j36H. Register for 
free, and the downloads page will open. Grab the files 
containing the source code Xyce-6.7.tar.gz, as well as 
the regression suite Xyce_Regression-6.7.tar.gz, and 
the documentation Xyce_Docs-6.7.tar.gz. These will 
arrive in your Downloads directory. 


cd ~/Downloads 

tar xzf Xyce-6.7.tar.gz 
cd ~ 

mkdir Xyce6.7 

cd Xyce6.7 
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Left Xyce is an open-source, fully functional circuit simulator 


The next line places the documentation in the 
proper Xyce folder: 


tar xzf ~/Downloads/Xyce_Docs-6.7.tar.gz 


Get the file config from the GitHub directory and 
make sure it is executable. Then compile and install, 
which will take an hour or so. 


chmod u+x config 
./config 

make 

sudo make install 


Next, we test things with the regression suite. 
Staying in the Xyce-6.7 directory, unpack and execute 
the regression suite: 


tar xzf ~/Downloads/Xyce_Regression-6.7.tar.gz 
cd Xyce_Regression-6.7/TestScripts 
./run_xyce_regression 


The regression suite takes a while to execute. A 
few tests related to calling Xyce as a library will fail, 
and the huge test problem (RCladder), which uses 
more memory than the Pi has, will fail, but the vast 
majority should pass. 


A sample problem 

A favourite test problem is a detailed model of 

the OP17 operational amplifier. The net list is 
available in the Xyce GitHub, as OP27.cir. Copy 
this file to a directory on your Pi, and run Xyce with 
the command: 


Xyce -l op27.log -o op27.prn OP27.cir 


The log file is defined by -1, -o defines the output 
file, and the final argument is the input netlist. This 
will only take a few seconds to execute. You can 
inspect the op27.log file to see how things went. 
LibreOffice Calc can be used to view .prn files, so use 
it to open op27.prn. Visualise the output by selecting 
the time and voltages, and creating a graph (x-y 
line). You can clearly see the inverting nature of this 
circuit setup. 


Start designing! 
Xyce will run most standard netlists for SPICE with 
just a few minor modifications. The Xyce Reference 
Guide in the Documentation folder lists the specific 
changes needed for several popular circuit simulators. 
Now you have a state-of-the-art circuit simulator 
on your Raspberry Pi for your next design project! 
Note that many manufacturers provide free SPICE 
models for their components on their websites. 
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FILE NAME: 
OP27.CIR 


DOWNLOAD: 
magpi.cc/2vl6loE 


MOVING 
XYCE TO 
ANOTHER Pl 


When you 
have a 
compiled 
version, 

only the 
libsuitesparse- 
dev libraries 
and the 
compiled code 
are required 
on another 
Raspberry Pi. 


EXTERNAL 
HARD DRIVE 


Use an 
external 
solid-state or 


hard drive to 
speed up the 
compilation 
and allow 
space for 
project files. 
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WALKTHROUGH 


GET SIARTED WITH 


NODE-RED 


Learn how to use the visual programming language designed for IoT 


n this tutorial, you’ll learn how to use 
Node-RED to communicate with the 
Raspberry Pi’s GPIO pins. Node-RED 


1*LED is a drag-and-drop visual tool which comes 
1 x solderless pre-installed on Raspbian. Here, we’ll create a 


breadboard Node-RED ‘flow’ to control LEDs. 


4 x male-to- By doing this, you’ ll learn how to set up Node-RED 
female jumper flows and use them to control GPIO pins. We’1l 


54 


leads 
also cover how to use Node-RED inputs, outputs, 


aecebeeee § = and a switch (equivalent toa selection statement); 
1 x tactile push and how to use Node-RED to simulate a NOT gate 
Putten acting on inputs from a button. 

To start, wire up an LED to GPIO 17 on your 
Raspberry Pi. Figure 1 shows how to do this. 


MagPi October 2017 


The positive leg of the LED is usually longer than 
the negative leg, and it is the positive leg that should 
be inserted into the left-hand side of the breadboard 
in this diagram. 


Start Node-RED 
Start up your Raspberry Pi. Click on the raspberry icon 


in the top left-hand corner of the desktop screen, then 
eo to Programming > Node-RED. This should launch a 
window displaying information about Node-RED. 

Now open the Chromium web browser. In 
Chromium, type localhost:1880 in the address 
bar, then press ENTER. This will display the 
Node-RED interface. 


raspberrypi.org/magpi 


. 

. 

om Z 

5 aeaa8 : 

; ‘aan 7 
aititoepiliili & 

a Triliaeritttlol 

a oREEEE @ BEEBE: = 

: emo) 

a 1 7 eee 

7 va ft i BES || 

a 3B aa8 | te tf BE 1. 

: ve pt i) ieee ee = 
i sea EEE meee e eis 


Figure 1 Wire up an LED to GPIO 17 - make sure you use the 
330 © resistor as shown 


Your Raspberry Pi does not need to be connected to 
the internet to use Node-RED: localhost is the address 
the Raspberry Pi uses to refer to itself and :1880 
means that it is looking at port 1880. 


Connecting to a GPIO pin 

Programs in Node-RED are called flows. You can see 
that your blank page is labelled as Flow 1 in the tab at 
the top (see Figure 2). You can create as many flows 
as you want, and they can all run at the same time. 

In this guide, we will create one flow. 

The coloured blocks on the left-hand side of 
the interface are the nodes. Scroll right down to 
the bottom of the list and you will see some nodes 
labelled Raspberry P1. 

You will see two nodes with the label rpi gpio: 
these are the ones we will use to talk to the GPIO 
pins on the Raspberry Pi. The first one in the list, 
with the raspberry icon on the left, is for inputs. 
Using a button-push to control something would be 
an example of an input. The second node, with the 
raspberry icon on the right, is for outputs. Switching 
on an LED would be an example of an output. Drag 
an output node onto the blank page in the middle 
of the screen. 


Edit rpi-gpio out node 


@GPIO Pin 11 -GPIO17 y PIS Model B 
Type Digital output ’ 
4 Initialise pin state? 
initial level of pin - low (0) ¥ 
* Name Green LED 


Pins in Use: 11 


lip: For digital output - input must be O or 1. 


Figure 3 Setting up a node for your flow 
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Tutorial 


‘Be Node feb a q 
i i] O focalost. 1480/0 for/afibode? 


a Flow 1 + bce 


am) Gr 


Double-click on the node, and a configuration box 
will appear (see Figure 3). Change the GPIO pin to 


GPIO 17 and make sure ‘Initialise pin state’ is ticked. 


Leave the setting for ‘Initial level of pin’ on low. Give 
the node a name — we called it Green LED because 
the LED we used was green, but if yours is a different 
colour, feel free to change the name. When you have 
finished, click Done. 


Injecting messages 

Now scroll back up to the list of nodes. To turn the 

LED on and off, we need an input. In Node-RED, we 

can inject messages into the flow and cause things to 

happen as a result. Drag an Inject node onto the flow. 
Double-click on the Inject node. Use the drop- 

down menu next to Payload to change the data type 


to string, and type 1 in the Payload box - this will be 


the message. Type On in the Name box. Click Done. 

Repeat the previous steps to create another Inject 
node, but this time add 0 as the payload message, 
and call this node Off. 

Now look for the grey dot on the right-hand side of 
the Inject nodes. Click and drag from the grey dot on 
the On node to the grey dot on your LED node to join 
them up. Repeat for the Off node, also joining it to 
the LED node. Figure 4 shows how this should look. 


Flow 1 


Figure 4 Putting the flow together 


Figure 2 The 
default Node-RED 
window as 

it appears in 

the browser 


e Green LED 
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Edit rpi-gplo in node 


Cancel 


@®cGPIO Pin 7 - GPIO4 * PIi3 Model B 


4 Resistor? pullup ’ Debounce| 25 m5 


“) Read initial state of pin on deploy/restart? 


*% Name 


Figure 5 The debug Deploying the flow Figure 7 Adding a button input is easy 
ool allows you to a : 
figure out where Our flow is finished, so now we can deploy it. Click Figure 5), then click Deploy. When you click the 

seam ets Ht on the big red Deploy button in the top right-hand buttons to inject the message, the Debug tab on the 
corner of the screen. A message should pop up at right-hand side of the screen will show you what 
the top saying ‘Successfully deployed’. This is like was injected. Click the tab to display the messages. 
pressing the green flag in Scratch, or F5 to run your ; 
code in Python. Adding a button 


Now click on the blue square on the left of the Onnode Now let’s adda button to control the LED. Wire 
to inject the message 1. The Green LED node receives the up your button to the Raspberry Pi as shown in 


message, and your LED should light up. You should be Figure 6, so that your LED is still connected to 
able to turn the LED off by clicking the blue square on GPIO 17, and your button is connected to GPIO 4. 
the Off node, which injects the message 0. Remove your Turn on and Turn off Inject nodes 
by clicking the node and pressing DELETE on the 
Debugging your flow keyboard. We no longer need these, as we will be 
If your LED doesn’t turn on and off, check that controlling the LED using a physical button. 
you have wired the components correctly on the Now we need to add a Raspberry Pi GPIO Input 
breadboard. Make sure you have wired your LED to node. This is the node with the raspberry icon on 
both ground and GPIO 17 on your Raspberry Pi. the left. Set up this node to receive input from your 
You can also ask Node-RED to display debugging physical button, as shown in Figure 7. 
information by wiring up your nodes to a Debug Specifying pullup means that GPIO 4 will be set 
node, which can be found under Output. Drag ina to HIGH, and pressing the button will cause it to 
Debug node, wire your two Inject nodes to it (see go to LOW. 
Figure 6 Wiring 
up the button 


doesn't require 
much more work 


mot 

6a aa ae BEB eo 
BEE” 
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Ea 
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GET STARTED WITH NODE-RED 


@ OK 


Figure 9 It is very simple to create a working circuit ina Node-RED flow 


Now join your Button node output to the existing 
Debug and LED nodes. Deploy the flow and test it by 
pressing the button. 

You will notice that the LED is lit to start with, 
and that pressing the button switches it off. That’s 
not quite right! This is because we are using pullup, 
so the button pin will be HIGH by default. HIGH 
generates the message 1, and this turns the LED on. 
When we press the button, we cause the pin to go 
LOW, generating a 0 message which turns the LED 
off. We need to reverse the values. We want the 
LED to receive the message 0 by default, and the 
message 1 when the button is pressed. 


Fixing the button 
Remove the connection you made between the 
Button node and the LED node by clicking on the 
line and pressing DELETE on the keyboard. 

Add a Switch node. This can be found in the 
Function section. This node is similar to the 
if/elif/else constructs you may have seen in 


Edit switch node 


* Name If input is 1 


Property + msy. payload 


>= 

it between 
contains 
matches regex 
is true 


iS NOt Mull 


otherwise 


Figure 8 The switch is needed to make sure the button 
can be used properly 
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Scratch or Python. You can configure it to have 
multiple output paths (outlined in red in Figure 8), 
depending on the value passed in. In this case, 

we will set up the node so that if the property 
msg.payload is equal to 1, the first path will be 
followed. Click the small Add button at the bottom 


Make sure you have wired 
your LED to both ground and 
GPIO 17 on your Raspberry P1 


to add a second path, and for this path select 
otherwise in the drop-down menu. This path will 
be followed if the input is anything other than 1. 
Figure 8 shows how your screen should look. Click 
Done when you have finished. 

You should see your newly created Switch 
node, with two dots on the right-hand side for 
outputs. Note that the title If input is 1is simply a 
description of what the node does, and has no effect 
on its function. Join up the GPIO input Button node 
to the input (left-hand side) of the Switch node. 

Now drag in a yellow Change node from the 
Functions section, and double-click on it to 
configure it. We will use this node to change the 
message being sent. Remember: when we created 
the Switch node, the first output was set to be 
followed if the input message was 1. We will use 
the Change node to change the message to 0. 

Press Done, then draw a line from the first 
output of the Switch node to the Change node. 
Then connect the output of the Change node to 
the LED node. Now add another Change node to set 
the msg.payload to 1. Connect this node to output 
2 of the Switch node, and then to the LED node 
(see Figure 9). 

This tells the flow that when the otherwise 
branch is followed (i.e. the msg.payload is not 
already 1), we would like to change it to1. When 
you are ready, deploy your flow, and then push the 
physical button to confirm that it works properly. 
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Tutorial WALKTHROUGH 


The hydroponic food garden one 
month after transplant: 100 pots 
containing about 450 plants 


KENT ELCHUK 


A Raspberry Pi enthusiast, web 
developer, and gardening author who 
is likely to be tinkering with code or 
working in the garden. 

growlode.com 


Set up a webcam with moisture sensors and remote access to ensure big yields 


> Motion 
magpi.cc/ 
2gVrlp2 


> Soil moisture 
sensor 
magpi.cc/ 
29X3lSN 


> USB webcam 


> Raspberry Pi 3 


he cost of food is rising. Why not use your Pi 

to build a hydroponic garden? Eat better and 

dodge those expensive food prices! Hydroponic 
erowing is efficient, healthy, and easy to maintain — 
especially when you can build a system that allows you 
to leave the garden, and monitor it remotely from an 
internet connection, for under S50 (£38). 

Growing pesticide-free, hydroponic, or organic 
hydroponic produce has never been easier — 
especially now that the Raspberry Pi is here to help. 
A hydroponic garden might not be the first place you 
would expect to find a single-board computer, but in 
this project it provides essential video monitoring and 
moisture detection. 

The project also uses a Raspbian-compatible 
plug-and-play webcam to provide the video, and 
the Motion Linux tool to handle the monitoring. 

To detect soil moisture, you can pick up a cheap 
breakout board online. The sensor can be assembled 
in minutes, with just a few connections that hook 
up to three Raspberry Pi GPIO pins and a moisture- 
detecting probe. 
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Moisture detection and video monitoring will 
provide the information you need to take care of your 
hydroponic garden, and you can be alerted to any 
problems via your internet connection. A simple home 
web server is all you need. 


Visual monitoring 

Nothing can replace visual monitoring of your 
garden. Using your webcam, you can inspect your 
crop from remote locations. First, you’1l need to 
install Motion: 


sudo apt install motion 

The next step is to edit the /etc/motion/motion.conf 
file. You will need to edit it in a text editor such as vim 
or nano: 


nano /etc/motion/motion. conf 


Carefully make changes to the file to match the 
following code. Until you make these changes, the 
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MONITOR A HYDROPONIC GARDEN ‘Tutorial 


There are two lights on the sensor The orange wire connects the 
board - one light will always be sensor board to GPIO 17, the red 
on, and the other switches on wire to ground, and the brown 
when water is detected wire to the power 


The moisture probe's 
metal plates are inserted 
into the plant pot 


system won’t work. It is a good idea to back up the ee : : toy BS os lel j re MOISTURE 
original file before making any changes. Te eet BeNOR arbre Hyg oD OEE aeAyy DETECTION 
daemon on A Sd ee" phate. a6 The system 
2 a. "30 , ‘ fm ~Oworks best 
; ; row, a '  _ Gi at detecting 
width 640 oe TA ARS Rs ¢ ‘3 ~~~ Zi new water 
} nk. 4 ae Ae j= saturation, 
# Image height (pixels). Valid range: eee ae oF ae ae gg saben 
Camera dependent, default: 288 x ey =} ; +2. Th Sele Aled ? 2. Pee = - the ongoing 


height A480 : =~ et “A ee ‘ ; 2 “Tr sal kat vy : | Es = re moisture 
| 1 9 eh ee ge Re - ve ee percentage 
with precision. 


framerate 5 
ffmpeg output_movies on 
snapshot_interval 60 


stream_localhost off 
webcontrol_ localhost off 


And finally: 


vi /etc/default/motion 


start_motion_daemon=yes 
The sensor is hooked 


eer) ee ee Wy Sree §€6Up to the GPIO pins, 
Restart the Motion service with sudo service ee TF SS and the webcam to 
motion restart. Always keep inmindthat youcan =) Of > * MMMAABilDdel gies HYDROPONIC 
use the update-rc.d command to ensure that a FEEDING 
program starts automatically after a fresh boot: WEBCAM INTERVALS 


sudo update-rc.d motion enable Check the Raspbian compatibility of any webcam 
before purchase. You'tl find a list of Pi-compatible 

When Motion saves video or JPEG files, they are webcams at magpi.cc/2gVs35G. 
stored in the /var/lib/motion folder. By default, the 


Use a timer 


to run one, 
two, or more 
predictable 
feeds per day. 
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Tutorial 


WALKTE 


The Pi keeps an eye on the garden 
and helps the author to check on it 


gos from remote locations 


REMOVE OLD 


IMAGES 


WIFI AUTO- 


CONNECT 


files are timestamped, and the most recent file is 
always titled lastsnap.jpg, which makes the file system 
easy to work with. 

During a Motion installation, it is likely that 
the folder where the files are saved will need new 
permissions. To give that folder owner and group 
permissions for Motion, type: 
chown -R motion:motion /var/1ib/motion 

At this stage, you should be able to access the 
Raspberry Pi from a browser (http://local_pi_ip:8081) 


and see the streaming webcam video — even after 
a reboot. 


Home web server 

A home web server is the easiest way to access 

the most up-to-date picture of the garden from 

a remote location. It also allows you to interact 
with the moisture sensor. To access your home 
server, type the home IP address into your browser. 
If you don’t know your IP address, you can find 

it at iplocation.net. 

It only takes a few commands to install a web 
server and PHP, and make your Pi into a home server. 
To keep this tutorial simple, the following commands 
show how to install the Apache web server and PHP: 
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sudo apt-get update 

sudo apt-get install apache2 

sudo apt-get install php7.@ php-pear 
libapache2-mod-php7.® php7.0-mysql 

sudo apt-get install php7.@-curl php7.@- 
json php7.@-cgi 


With these packages installed, you should be able to 
view the new website at your IP address via a browser 
or with a free online proxy. Make sure your router 
can forward port 80 to let you see the webpage, and 
optionally port 8081 for live streaming. 


Monitoring water 

The soil moisture sensor is acommon Pi add-on, 

and hooking it up is easy. The moisture sensor board 
connects to three GPIO pins on the Pi: GPIO 17, power, 
and ground. The sensor board is also connected to the 
metal plates of the moisture probe. 

The unit works straight away — all you need to do is 
stick the probes into a pot. If you see only one light 
on the sensor board, add some water. After adding 
water, you Should see two lights. In our experience, 
the moisture detection light illuminates after 
watering, but the sensor board can go down to one 
light within an hour, even though the soil or growing 
medium has retained some moisture. You can use 
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this system to make sure a scheduled watering 
has happened. 

The script used in this project to detect moisture 
uses PHP. PHP has a shell_exec() function that allows 
the easy use of Linux shell commands instead of using 
a GPIO library. Find the code in the code listing box. 


Remote access 

Let’s start tying everything together. We have a script 
that detects watering, and lets us know if watering 

is on or off. Watching this is very easy: just open the 
page in a browser. 

Since seeing is believing, viewing the lastsnap.jpg 
file lets you see how the plants are doing at any time. 
This image is saved to the Motion folder, and you can 
set up acron job (use crontab -e) to move this file to 
the HTML folder and display it in the browser: 


* * * * * Cp /var/lib/motion/lastsnap. jpg 
/var/www/html/test.jpg && chown pi:pi /var/ 
www/html/lastsnap. jpg 


The resulting page shows the live stream, the most 
recent image, and a message reporting the results 
from the sensor. Save the URL to your phone and open 
it at will. You can display your data as shown in this 
tutorial, or just set up the parts you want to use. 


Hydroponics basics 

Although the focus of this article is about monitoring 
the plants, it is helpful to know a little about vertical 
hydroponics, which uses interlocking quad pots 
stacked on top of each other. 

When growing, tomatoes can be stacked two or 
three pots high; lettuce, cucumbers, and peppers do 
well with five or six pots stacked up. The stacking 
gives very high yields per square foot. 

To feed the plants, nutrients are delivered using a 
pump that sends liquid nutrient through half-inch 
polythene tubing. Along the half-inch header line, 
barbed fittings are inserted so that quarter-inch 
tubing can send fluid to each pot. Irrigation into the 
pots takes place slowly, regulated by drippers inserted 
into the ends of the pipes. 

Plant stakes are used to hold the drippers in place. 
At the very bottom of the system are individual 
three-gallon (11-litre) pots that catch the waste 
nutrient. These bottom pots also hold plants. 

In each pot, you can use a medium like soilless mix, 
coco coir, peat/perlite mix, or even well-draining dirt. 
As far as feeding is concerned, any hydroponic plant 
fertilizer is fine — powders are often much cheaper 
than liquid. A food-grade 55-gallon (208-litre) drum 
makes a good, cheap, food-grade nutrient tank. 

When you mix a nutrient solution, a pH pen and 
EC/TDS (total dissolved solids) meter will help to 
fine-tune the plant diet. You can cut costs by using 
PH test strips or a liquid pH test solution. Normally, 


raspberrypi.org/magpi 


MONITOR A HYDROPONIC GARDEN 


@ 
indev.txt 
<img src="http://local_ip with_ 


motion _service:8081/" width="320" 
height="240"/> 


DOWNLOAD: 
magpi.cc/2gVYroO 


<img src="lastsnap.jpg" width="320" height="240"/> 


<?php 

gon_off = shell exec('gpio read Q'); 
echo $on_ofF¥; 

IrCSOnLOnh ==) )q 

echo "<br/>It is off"; 

yelse{ 


echo. <br/>1t as on! <br/>; 


your water and mix pH values will be consistent, so 
you shouldn't need to test them very often. A pH of 
6.0-6.5 works for most vegetables, while 1500-1800 
ppm (parts per million) TDS indicates a decent 
fertilizer salt concentration. When growing lettuce, 
a lower TDS value (400-500) may be sufficient. 

Hydroponically grown produce can yield big 
harvests and lots of growth, so be ready to supply 
some support for your giant plants! On the other 
hand, lettuce is easy to care for, and many varieties 
of tomatoes will trail downwards without requiring 
any support. 

As well as producing plenty of pesticide-free food 


all year around, a growing garden can bring enjoyment 


and peace to your home. 


Above The author 
in his vertical 
garden, which 
requires less 
than ten minutes 
of maintenance 
every day 
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FREQUENTLY 
ASKED QUESTIONS 


YOUR QUESTIONS ANSWERED 


NEED A 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 


USING YOUR RASPBERRY PI 


AS A SERVER 


62 


: 
‘ i 
i 
ae 
(ik * 
th 
1 
4 
| 
1 
| 
+. ha 
4 


Conventional server 

Think of a server as a big computer that smaller 
computers, such as your desktop or Raspberry Pi, 
communicate with to get information. This could be 
online, to open a website, or to download a file from 
your favourite cloud service. They’re generally more 
powerful, and have much more storage, than an 
average PC. 


Home server 

A home server is a scaled-down version of an online 
server. On a home network, where only a few devices 
will be accessing it at any one time, you don’t needa 
very powerful system to act as a server. In fact, most 
home servers are less powerful than a desktop PC, and 
it is common for people to use an old PC as a Server. 


Raspberry Pi server 

A Raspberry Pi may not be powerful enough to use as 

a conventional server, but it is perfect for use at home 
or in a small office. Using a spare Pi to serve files and 
media to your network can be a great and cheap way to 
meet your file storage and sharing requirements. 


Storage 

You’ll need to add extra storage to the Raspberry Pi 

if you want to use it as a server. Depending on your 
requirements, you could use a large USB flash drive ora 
USB portable hard drive. The hard drive may be slower, 
but it will allow for constant writing and rewriting. 


Operating system 

You’ ll find plenty of tutorials demonstrating how 

to set up a Server using Raspbian, but there are 
other operating systems for the Pi that offer server- 
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specific tools. Arch (magpi.cc/2nf6YFk) and Fedora 
(magpi.cc/2miaZUL) are highly customisable and 
secure; Chromium OS (magpi.cc/2njuVeS) offers a 
web kiosk setup; and PiBox (magpi.cc/2x4nutO) is 
optimised for use as a media server. 


Networking 

The built-in wireless LAN on the Raspberry Pi 3 and 
Pi Zero W is faster than a wired Ethernet connection. 
A wired connection will be more stable, but may 
involve trailing wires around your house. You’11] 
need to decide what will work best for you. 


Low power 

The Raspberry Pi draws very little power, so you can 
leave it running 24/7. Linux-based operating systems 
are very stable, so a Raspberry Pi server is well equipped 
to run for long periods of time. 


Size 

Even the largest Raspberry Pis are only the size of a 
credit card, giving your Pi server a very small footprint. 
The Pi Zero is even smaller, and some makers have 
created home servers where the Zero is built into the 
mains plug that powers it (magpi.cc/2y3dNLP). 


Community 

Want to set up your Raspberry Pi server? The Raspberry 
Pi community is very active, and provides tutorials and 
solutions for almost any problem, including specific 
server setups. You may even find suggestions in the 
forums that you hadn’t thought of, which will make 
your computing life even easier. 
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FROM THE RASPBERRY PI FAQ 
RASPBERRYPI.ORG/HELP 


WHY IS THERE NO REAL-TIME CLOCK (RTC)? 

The expectation is that non-network-connected units will 
have their clocks updated manually at startup. Adding an 
RTC is surprisingly expensive once you have factored in 
batteries, area, and components, and would have pushed 
us above our target price. You can add one yourself using 


the GPIO pins if you'd like an interesting electronics project. 


WHY DOESN'T THE RASPBERRY PI INCLUDE <INSERT 
NAME> PIECE OF HARDWARE OR <INSERT NAME> SORT 
OF PORT? 

Our main aim is a charitable one: we are trying to build the 
cheapest possible computer that provides a certain basic 
level of functionality, and keeping the price low means 
we've had to make hard decisions about what hardware 
and interfaces to include. 


YOUR QUESTIONS ANSWERED 


CAN | ADD EXTRA MEMORY? 

No. The RAM on the Model A, A+, B, B+, and Zero is a 
Package on Package (PoP) on top of the SoC, so it is not 
removable or swappable. The RAM on the Pi 2 and 3 
Model B versions is on a separate chip on the bottom of 
the PCB, but 1GB is the maximum RAM that the SoC used 
by the Pi 2 and 3 Model B versions can support. 


WHAT IS ITS OPERATING TEMPERATURE? 

The Raspberry Pi is built from commercial chips which are 
qualified to different temperature ranges; the LAN9514 
(LANg512 on older models with two USB ports) is specified 
by the manufacturers as being qualified from 0°C to 70°C, 
while the SoC is qualified from -40°C to 85°C. You may well 
find that the board will work outside those temperatures, 
but we're not qualifying the board itself to these extremes. 


KEEP MULTIPLE 
PROJECTS IN 
ONE PLACE 


WD PIDRIVE FOUNDATION EDITION 
MADE FOR RASPBERRY PI 


Our custom NOOBS software enables you to install 
multiple work spaces for up to 5 projects that can all be 
managed from the WD PiDrive. 


CHOOSE THE 
STORAGE THAT'S 
RIGHT FOR YOU: 


USB FLASH 64GB 


Includes microSD™ card 
with starter software 


$18.99 


USB HARD DRIVE 
250GB /375GB 


Includes microSD™ card with starter 
software and WD PiDrive Cable 


Starts at $28.99 


Learn more at wdlabs.io 


© wDLass 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark of the Raspberry 
Pi Foundation. microSD is a trademark of SD-3C, LLC. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies depending on operating 
environment. Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 
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Special $10 MagPi coupon: 


ee ewe ew wee we ee eee ee eee ee eer eee . 


: MagPiSummer 


only at BuildPiper.com 


‘It’s a really fun educational computer kit 
that should really impress those who love 


Minecraft and building stuff” Mii ® 
| ag?i 


Want to learn how to bring Piper to your school? 


buildpiper.com/EDU 


THE PIPER EXPERIENCE 
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SOFTWARE-BASED CURRICULUM CREATE YOUR ELECTRONICS 
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Supported by Top University Funds 
Stanford-StartX Fund 
AEF of Princeton University 


Available at: 
BuildPiper.com amazon ys$iu BARNES <cNOBLE 


GOT A GAP IN THE DIARY? \\\ 
FILL IT WITH AN AWESOME RASPBERRY Pl PROJECT. 


» hat will you say when your gr 
J friends and colleagues ask 
~ you what you did at the 
weekend? Watched a film, went out 
for lunch, or had a lie-in? 

Give them a better answer: in this 
project roundup we show you what 
you can achieve in two days. You 
could build a robot, upgrade your 
family’s toys, or fashion a sparkling 
bag. You could connect your fridge 
to the Internet of Things, or hack a 
stereo to play your theme song when 
you walk into the room. 

Many of the projects are family- 
friendly, so younger makers can join 
in. Let’s get started! 
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feature 


_ \ ere’s a cool project: a drinks 
- fridge that uses a scale 

to work out how many 
bottles are inside, a temperature 
sensor to help you keep the beers 
chilled, and another sensor to 
detect when the door is opened. 
The data can all be streamed toa 
web-based dashboard. 


Jamie Bailey conceived the project 
as a way to Stop his house-sitting 
19-year-old nephew from stealing 
his beer. Now, if a bottle is removed 


from the fridge, Jamie gets a text 
message and can call his nephew 
Do You NEED To BUY MORE to Tak him off before the Ate is 
BEER, OR IS SOMEONE AT HOME Predera Bae on thata 
STEALING YOURS? 
LET YOUR FRIDGE TELL You, 


web-connected scale was going to 
be an effective, non-intrusive way 


’ )) 


to make my beer fridge ‘smart’, out how many bottles are inside 


USING A WEB DASHBOARD. 


JAMIE BAILEY 


Jamie is the CEO and 
founder of Initial State. He 
has 16 years of experience 


in product development, 


Jamie says. “I didn’t want to 

drill any holes in my fridge or 
worry about communicating with 
electronics from inside a closed, 
cold box. Finding a web-connected 
scale was frustrating because there 
really weren’t any products on the 
market that I could use. Once | 
figured out that I could hack a Wii 
Balance Board to talk to a Pi, the 
project was truly a go.” 


the fridge. 

Data is streamed to a dashboard 
designed by Initial State, the 
company Jamie founded, which 
provides graphs and the ability to 
trigger a text message alert. 

“It was so cool to take something 
that I already had and turn it into 
a data collecting, peace-of-mind 
appliance that no one else in the 
world had,” Jamie says. “It has been 


integrated circuit (IC) ; 
The Balance Board sits such an awesome conversation 


underneath the fridge and piece when friends and family 

connects to the Pi over Bluetooth. come over.” 

By knowing the weight of the Visit the link for a detailed guide, 

magpi.cc/2xy028v fridge and the weight of a bottle, including the code to create your 
eee > © e e » Jamie’s Python code can work own smart fridge. Cheers! 


design and testing, 
embedded systems, and 


software development. 


ADD THE SCALES ADD THE SENSORS STREAM DATA 
You can't pair the Balance Board with The magnetic contact door sensor You can stream data to an Initial 
the Pi permanently. Use a pencil as connects to the Pi througha State dashboard in JSON format 


a lever so you can press the sync breadboard, with a 10 kQ resistor. or with URL parameters. Download 
button, even with the fridge on top. The temperature sensor sits inside Jamie's code to test your sensors 
the fridge, with the wires running and set up your fridge. 

through the door seal. 


Closed 
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TALKIEPI <x, 


Do YOU WANT TO MAKE INTERNET-CONNECTED WALKIE- 


TALKIES FOR ALL THE FAMILY? THAT'S A BIG TEN-FOUR! 


, atching Netflix series 
Stranger Things inspired 

—_ Daniel Chote to make some 
“big ol’ 1980s walkie-talkies” for 
his family. His children Eddie (6) 
and Ollie (3) can use them to chat 
to each other, and to their friends, 
through an internet-based server. 

The software core is Mumble, 
an open-source voice chat system 
designed for use by PC gamers. 
There are clients for a range of 
operating systems, so the TalkiePi, 
as Daniel has named his project, is 
compatible with many other apps 
and devices. The software can be 
used to connect groups of people 
who can chat to each other, like 
using channels on a traditional 
walkie-talkie. 

Daniel used a US Robotics USB 
Speakerphone, which sells for less 
than S12, as the heart of his device. 
He removed its case and connected 
its board to one of the Raspberry 
Pi 3’s USB ports. 

He wired up some simple 
components to the Pi’s GPIO pins: 


SOLDER THE LEDS 

Connect the push-button. Solder the 
status LEDs to wires, and connect 
those wires via 330 Q resistors to 
your GPIO pins. Daniel uses a GPIO 
header connector. 
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a push-button to use when talking, 
and two status LEDs at the bottom 
of the speaker. One is illuminated 
when you’re connected to the 
Mumble server, and the second 
lights up when other people are in 
the chat room. A third LED inside 
the button lights up when the 
TalkiePi is sending your audio. 

Daniel designed a case to house 
the device using Autodesk’s 3D CAD 
software Fusion 360. The case was 
printed using a Monoprice Select 
Mini 3D printer. 

For now, the device is 
powered using a wall socket, but 
possible enhancements include 
portable power. 

You can find Daniel’s code 
and 3D-printable design files at 
magpi.cc/2vKbHP3. 

Daniel’s advice to other makers? 
“Keep it simple - be creative,” 
he says. “Don’t be afraid to learn 
new programming languages, or 
even something like Fusion 360 
for CAD.” 

Roger that! 


ADD THE SPEAKER AND MIC 
Unscrew the speakerphone. Connect 
a right-angled mini USB cable to the 
Pi's USB port. Use it to connect the 
speakerphone's circuit board to the 
Raspberry Pi. 


rr 


DANIEL CHOTE 


Daniel is a believer that 
everyone can learn new 
things. If something 
interests you, there really 
isn’t anything stopping 
you from attempting to 
do it yourself. 
Magpi.cc/2vsqMtx 
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MAKE A CASE 


You can 3D-print Daniel's design. If 
you don't have a 3D printer, you can 
make your own case from cardboard 
or LEGO, or use the project 

without a case. 
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ROBOT 


MAKE A ROBOT IN A WEEKEND, 
WHETHER YOU'RE MAKING YOUR 
FIRST OR ADDING To YOUR ARMY 


ey 


MARK NORWOOD 


» hen Mark Norwood saw a 
| £5 spider robot toy in Tiger, 
“he thought: “That would 
make a great Raspberry Pi project for 
someone! Hey, that someone could 
be me!” 

The toys scuttle forwards when the 
power is on, but now Mark has joined 


Mark Norwood is a teacher 
working in Bedfordshire, 
specialising in teaching 


problems. In his spare time 
he walks, he dreams, and is 
a Cub Scout Leader. 
magpi.cc/2vsnhDs 
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two of the toys together to create a 
spider that can walk forwards and 
backwards, under the control of a 
Raspberry Pi. The robot, Mr Nancy, 
uses the right legs from one toy and 
the left legs from another, so they 
can be controlled independently. 

The robot is based on the 
Raspberry Pi Zero W. Mark uses parts 
from the CamJam EduKit 3, which 
provides everything you need to 
make a simple robot - in particular 
the motor controller board which 
enables the Pi to control the motors. 
The Raspberry Pi is powered using a 
power pack from Poundland, while 
four AA batteries drive the legs. 

For the software, Mark used 
a combination of Scratch for 
line-following, and Python for 
the distance sensor and obstacle 
avoidance. He uses RealVNC on 


his Chromebook to view the user 
interface running on the Pi Zero. 

This is Mark’s second robot based 
on the CamJam EduKit 3, following 
his Robocroc which motorised a 
plastic shoe. “The kit is cheap, and 
has everything you need, with good 
instructions on the CamJam site,” 
he says. “Everyone in the community 
knows it, so they can give you help if 
you need it.” 

He found the GPIO Zero examples 
on the Raspberry Pi website helpful, 
and his advice to others building 
robots is to “dabble with GPIO Zero, 
because it massively reduces the 
amount of coding you have to do.” 

Mark’s website includes a 
detailed photo essay showing the 
construction of Mr Nancy, and you 
can find out more about the CamJam 
kit at magpi.cc/2xxPy8X. 


CHOOSE YOUR 


Mark used two of these spider toys 
for Mr Nancy, but you could build a 


robot using a pencil 


box, or a LEGO design. 


CHASSIS 


case, a cereal 
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ADD THE MOTOR BOARD 
The motor controller board from the 
CamJam kit sits on your Pi's GPIO 
pins. Wire your motors into the left 
and right terminal blocks, and your 
motor battery to the middle block. 


ADD ADDITIONAL SENSORS 

This distance sensor comes from the CamJam kit, anda 
line-following sensor is also included. Use the CamJam 
software to test them and add them to your robot. 
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WEEKEND PROJECTS 


feature 


~ DOORJAM 


MAKE YOUR FIRST IMPRESSION COUNT BY TRIGGERING 
YOUR THEME SONG AS YoU ENTER THE ROOM 


s you walk through the 
door, the bass starts 


to look. You’re here, so it’s time to 
get the party started! 

You’re using Doorjam, which 
triggers your theme song as you 
enter the room. It works like this: 

a Raspberry Pi 2 emits a Bluetooth 
Low Energy iBeacon signal, which 
can be detected by an iPhone. The 


pumping and all heads turn 


Bleno Node package enables a USB 
Bluetooth dongle to act as an iBeacon. 

On the phone, an app detects 
the iBeacon and sends a signal to 
a control server containing the 
Spotify ID of the user’s song, and 
the ID of the iBeacon that has been 
found. The server uses Node.js to 
push a command to the Pi to tell it 
to play the music. Having the server 
means that you can use the setup 
to coordinate a whole network 
of iBeacons across your building 
or town. 

“Bluetooth beacon ranging is 
noxiously jumpy,” says Matt Reed, 
who made the project. “An app may 
think you’re between three and 
ten metres away from a beacon at 
any given second. The Bluetooth 
received signal strength indicator 
(RSSI) value is affected by obstacles 
and other radio interference. | 
overcame this by using an easing 


J MATT 
€) REED 


fa 


equation to smooth the distance 
proximation to the beacon. This 
slows down the detection but makes 
it more accurate, because you’re not 
out in the parking lot while your 
theme song is playing inside.” 

This weekend project is best 
suited to those with some Node.js 
experience, but Matt’s blog includes 
essential code snippets for the Pi 
and the phone. 

What is Matt’s choice of tune? 
“T’m ona Boat by Lonely Island 
Boys,” he says. “Don’t ask me why, 
I just love that song and it makes 
me laugh every time.” 

What will your tune be? 


MAKE YOUR 
TRIGGER 
The app (built 
using PhoneGap) 
enables users to 
look up the ID 
of their Spotify 
song, and tracks 
the distance to 
the iBeacon 
when it is 
detected. At 
less than 10 ft 
(3 m), it cues 
the music. 


CONNECT BLUETOOTH AND wiIFI 

Matt used a Raspberry Pi 2 because he had one handy, so 
he added dongles for wireless and Bluetooth connectivity. 
You might prefer to simplify the project by using a Pi 3 with 
wireless and Bluetooth connectivity built in. 


CONNECT THE PI 

The Pi's audio out goes to the 
boombox's audio in. A power supply 
(left) and 4G hotspot (right) on the top 
enable the unit to work anywhere. 


, Revel 
Bai} 
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6) EPIC 


WEEKEND | 


TO ROUND OFF YOUR WEEKEND IN STYLE 


GIF CAMERA 


Nick Brewer and his wife Shayna designed a Pi 
Zero camera for recording animated GIFs. The 
power comes from a LiPo battery connected toa 
PowerBoost 500C to boost its output to 5 V. A button 
connected to the GPIO is used to trigger the photo, 
and an LED lights up while the GIF is being recorded. 
The camera has a 3D-printed case design, and 
printable paper wrap-arounds to make it feel like 
a disposable film camera. 

magpi.cc/2vuEBaK 
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TOTE 


Amanda Haughs designed a tote bag with a Pi Zero 
concealed in a pocket. It controls seven 5 mm clear 
white LEDs in the embroidered Raspberry Pi logo, 
which light up in a random order. 8-inch female-to- 
female jumper cables are used to connect the LEDs 
to the Pi and resistors. Amanda used GPIO Zero to 
pulse the lights, and a cell battery for power. The 
rc.local file was edited so that the program runs 
when the Pi boots. 
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THE SMART PHONE 


B 
° 

» Simon Jackson put the Google 

® ATY Projects Voice Kit into a 

~ Fisher-Price telephone, creating 
. amore interactive toy for his 

® six-year-old son Owen. The 


© biggest challenge was getting knife tip,” he says. 
. all the components to fit into magpi.cc/2es19Sj 
»>@®O80C CHOC 8 C0288 @E »eeec @ 


ARCADEMACHINE ———==—h. 


With Lakka and Recalbox in NOOBS, and RetroPie readily 
available, there are lots of software options if you want 
to play the games you grew up with. There are several 
controller options, too: Pimoroni’s Picade supports 
joysticks and arcade buttons, and The Pi Hut makes a 
SNES-style gamepad. Nate Douglas made this arcade 
cabinet based on RetroPie using a Pi 3, half-inch 
medium density fibreboard (MDF), a Samsung 

22-inch LED monitor, speakers, and a keyboard. 
Magpi.cc/2vuCZhc 
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the housing. “I had to source a 
smaller speaker to save on space. 
Then the only way I could get the 
Pi to fit was to cut the rear wheel 
arches with a soldering iron hot 
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* LEGO BOAT 


, Ten-year-old Ozzy Hayler made a Pi-driven 
® LEGO boat, using a balloon for buoyancy. 
® © The Pi Zero uses the Explorer pHAT as a 
5 . motor controller, and it drives a micro metal 
‘si*e gearmotor. Power comes from a LiPo battery 
and LiPo shim. The remote pins function of the 
_  GPIO Zero library is used to control the Pi from a 
. laptop. “Keep the motor and Pi dry,” he advises. 
e ® “Ttested it in a bowl of shallow water first.” 
| magpi.cc/2erYg4l 
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MEARM Pl 


Waker 
days 


An easy- — =, 


wae 


to-build robot 
arm kit that's 
designed to 
get children 
learning 
about 
technology, 
engineering, 
and 


programming 
Mime Industries 


- —- 


MEARMI P 


This fun robot arm will grab the interest of children and adults alike 


ong-time readers of puzzle was the need for users find 
The MagPi may recall that their own way to drive the servos 
we reviewed the original from a Raspberry Pi. The new 
MeArm back in issue 33. While we =MeArm Pi solves the problem by 
Related loved the concept of an affordable, including a HAT with twin on- 


open-source robot arm, we did board joysticks, so now you have 


Not only that, but the arm 
itself has been completely 
redesigned, eliminating two- 
thirds of the screws and using 
new fixings to make it easier 
to build. It certainly is a lot of 


MAPLIN note that a missing piece of the everything you need in one kit. fun to put together, like a cool 
ROBOTIC motorised Meccano set. Step-by- 
ARM Below The joystick controls 


are ona HAT that slots easily step illustrated instructions are 


74 


ee ae onto the Raspberry Pi Supplied online — two versions, 
ineroiok for a standard-size Pi or a Pi Zero. 
arm can be Most of the acrylic pieces simply 
scan slot together, secured by a few 

Pi using the rubber bands, while three lengths 
PyUSB module of screws are used for the moving 
in Python. 


£55 /9$73 
magpi.cc/2dLweuN 
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joints. A hex key is supplied for 
this purpose, but you need to 
avoid overtightening the screws 
so that the joints can move freely. 
The design is well thought out, 
with strategically placed holes for 
the servo cables to pass through 
to keep them tidy. We found the 
trickiest part was sliding the arm 
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into the base, which required 
prising the two layers apart; we 
also needed to loosen the base 
servo horn slightly to enable it to 
move freely. 

The case that houses the 
joysticks also features cut-outs 
for the Pi’s ports, although 
there’s no easy access to the SD 
card, so you’|ll need to download 
and write the special OS image to 


it before you enclose the Pi. Based 


on Raspbian, the OS includes all 
the required software and creates 


a wireless access point so that you 


can connect to and program the 
MeArm Pi directly from a remote 
computer or tablet. This means 

it can be used headless, without 
the need for a monitor, keyboard, 
and mouse. There’s also the 
option of connecting it to your 
WiFi network if you prefer. 


Twist your arm 

Once the system has booted up, 
which takes about 75 seconds 

on a Pi 3, the arm jerks into life 
and you can then control it using 
the twin joysticks. This is a lot 
of fun — like controlling a mini 


digger, albeit with a claw. The left 


stick handles base rotation and 
lower arm movement, and the 
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right stick controls the upper arm 


and claw grip. While the servos 
are pre-calibrated to be used out 
of the box, we did encounter an 
issue with the grip not closing 
fully at first, but this was easily 


MEARM PI 


functions (and sample code) 

for moving the arm’s servos by 
degrees for accurate control. 
Naturally, you can set up loops 
and conditionals to get the arm 
to behave in sophisticated ways. 


Most of the acrylic pieces 
simply slot together, secured 
by afew rubber bands 


rectified by unscrewing and 
repositioning the servo horn. 
There is quite a lot of buzzing 


from the servos, but we found the 


control was accurate enough for 
us to pick up small objects, such 
as cherry tomatoes and socks. 

A more interesting and 
educational way to control the 
arm is by programming it. While 
you can do this directly on the 
Pi, an easier way to get started 
is by connecting a PC or tablet 
to the MeArm Pi’s local web 
server, by pointing a browser to 
local.headlesspi.org. This gives 
you access to four apps, each 
for a different programming 
language: Blockly, Snap!, Python, 
and JavaScript. These include 


There’s even the potential to 
add a Camera Module to the end 
of the arm (using an extra-long 
ribbon cable) and use OpenCV 
for image or face recognition to 
control it - as demonstrated by 
Mime (magpi.cc/2ffXB2)J). 


fast word 


Despite a few teething troubles, we found the 
MeArm Pi a joy to build and use. Manual control 
using the joysticks is great fun, but programming 
it is ultimately more rewarding. The headless 


setup and local web server make it very easy to 
get started, offering a choice of four programming 
languages, although you could still opt to code it 
directly on the Pi instead. 
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Waker 
days 


Perfect 
for all your 
Raspberry 
P| gaming 
or robotics 


needs 
The PiHut 


WIRELESS USB GAME CONTROLLER 


GAME CONTROLLER 


USB 
GAMEPAD 
(SNES-STYLE) 


Not wireless, 
but a classic 
SNES-style 
controller 
that's perfect 
for recreating 
classic gaming 
moments. 


-@O 


~~ a 


~ £6/5S8 
magpi.cc/2ve6iUo 
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This versatile controller is easy to set up and great to use 


he Raspberry Pi3 is an 
excellent base for retro 
gaming projects. With 
its speedy 1.2 GHz processor and 
wireless networking, you can set 
up aconsole in your front room 
and bounce ROMs to it from 
another computer. 

Retro gaming consoles need a 
controller — arcade games are little 
fun to play with a keyboard and 
mouse. And if you’re building a 
retro games console, this Wireless 
USB Game Controller is a great 
companion device. 

The style will be familiar to Sony 
gamers. To our eyes, it’s based 
on the PlayStation Dual Shock 
from the PlayStation One days. 

It features a D-pad, four buttons, 
two analogue control sticks, and 
four trigger buttons. In the middle 
are Select, Start, Analog, anda 
mysterious Turbo button. 


All of this is powered by three 
AAA batteries, which we find 
easier than charging up via a USB 
cable. On the rear of the device 
is an on/off switch that is used 
to connect and disconnect from 
the Raspberry Pi. 

The feature we like most 
is the 2.4GHz Wireless USB 
receiver dongle. Instead of going 
through the awkward Bluetooth 
pairing process, you plug in the 
USB dongle, and it connects 
Straight away. 

We tested it with RetroPie 
and are pleased to report that it 
worked first time without any 
issues. AS soon as we booted 
into RetroPie, the Wireless USB 
Game Controller appeared as 
a device, enabling us to assign 
buttons to controls. You will find 
a RetroPie video installation guide 
here: magpi.cc/2doUHrd. 


During a game test, we found 
the Wireless USB Game Controller 
comfortable to hold and perfectly 
fine to use. It’s not quite up there 
with the original Dual Shock, but 
it’s not far off, and better than 
most third-party controllers. 

You can also use the Wireless 
USB Game Controller to control 
robots — we looked at building a 
Remote Control Robot in The MagPi 
issue 51 (magpi.cc/Issue-51). 


fast word 


One of the best games 
controllers we've found. Works 
right out of the box andisa 


comfortable, professional, 
and slick piece of kit. A perfect 
companion for retro gaming. 
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MONKMAKESDUINO LCD KIT 
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It will 
provide you 
with hours of 


entertainment, 


building 
projects, and 
learning how 


to Drogram 
MonkMakes 


DISPLAY-O- with Arduino, you can probably simple messages such as a live many projects. 

TRON HAT connect the two together. temperature reading. 

AHAT for the Pi Unlike the Raspberry Pi, which Being a MonkMakes kit, it also 

with a three-line 7 y ; 7 ; fast word 

LCD display that is a full computer, Arduino boards comes with much more than the 

is fun and easy like the MonkMakesDuino are board and LCD screen. Included A great kit that will teach you 
microcontrollers. You write code is aselection of LEDs, buttons, 


to program. 


£22 / $28 
magpi.cc/2y3DM5C 
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MONKMAKESDUINO _ 


she =” 


LCD KIT 


Have fun programming in a new way with the MonkMakesDuino LCD Kit 


hile not specifically a 
Raspberry Pi product 

Or project, the 
MonkMakesDuino LCD Kit is a great 
educational tool for coding, ina 
similar vein to the MonkMakes Pi 
kits that we’ve looked at in the past. 
In fact, with our feature from issue 
61 about using the Pi to interact 


on another computer, which you 
then upload to the board for it to 
run. This has various advantages 
and disadvantages depending 

on how you use the board (for 
example, a microcontroller uses 
less power, but isn’t as powerful). 


For this kit, it’s just a different 
way to learn about coding and 
using electronics. 

It’s called the LCD Kit, as the 
main component it comes with is 
just that: asimple LCD screen. It’s 
not a full-colour display, but a two- 
line text display with 16 characters 
on each line, allowing you to print 


sensors, and jumper wires, along 
with a breadboard, so you can try out 
different setups and projects. The 
quality of the included projects is 
fantastic, with easy-to-understand 
tutorials on how to create cool 
effects with the LEDs, and make 


a countdown timer on the LCD. 
There’s a great online repository of 
code examples as well, so you don’t 
have to type out everything by hand. 
Thanks to the array of 

components, this kit will definitely 
be useful once you’ve finished with 
the instruction book — buttons 

and LCD screens are useful for 


another aspect of coding - 
while also having lasting use 


beyond the tutorials in the 
book, thanks to its great array 
of electronics components. 
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Raspberry Pi for professional applications 


ik 


SU QUO 


Strato Pi enhances the Raspberry Pi and the Compute 
Module with hardware features that make them 
suitable for use in professional applications where 
reliability and service continuity are key requirements. 


CE/ROHS 
CERTIFIED REAL TIME HARDWARE 
CLOCK WATCHDOG DIN-RAIL 


Si 


RS-232 / 
RS-485 


WIDE RANGE 
POWER SUPPLY 


OP? 
LOO 
lono Pi is a versatile 1/0 module that 
combines digital and analog standard 


= ak eeee * 
interfaces with the powerful orca 
computing core of the Raspberry Pi. aE 
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RASPBERRY PI 
BESTSELLERS 


As the nights draw in, Make will 
entertain, educate, and upskill 
your children. 


WOODWORKING 
FOR YOUNG MAKERS 


Authors: Loyd Blankenship, a 
Lane Boyd 

Publisher: O'Reilly 

Price: £10.50 

ISBN: 978-1680452815 

magpi.cc/2vYnYZH 


Teach your kids woodworking 
skills with these well-chosen 
projects: a wizard wand, a 
sanding block, a charging 
station, and a sturdy box with 
a hidden compartment. 


ELECTRICITY FOR 
YOUNG MAKERS 


Author: Marc de Vinck —— 

Publisher: O'Reilly Make: ——_— 

Price: £10.50 ELECTRICITY a 
YOUNG MAKERS, 


ISBN: 978-1680452860 
magpi.cc/2vYxGILP 


Asmall collection of projects 
using easy-to-obtain items 

that combine fun, education, 
and a reasonably good chance 
of success — even for young 
children with non-techy parents. 


MAKE: PAPER INVENTIONS 


Author: Kathy Ceceri 
Publisher: O'Reilly 
Price: £15.99 

ISBN: 978-1457187520 
magpi.cc/2vYomhl 


Paper, switches, sensors. 
Wearables from foldables. 
Edibles. Generators and 
geodesics. Space rovers and 
sun Spirals. Craft meets maths, 
and next time you're looking 
to occupy bored kids, you'll 
bless Ceceri's fertile mind. 
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THINK PERL, 6 operator precedence, loops, basic 


data structures, and algorithms. The 
CT eee second half covers more 
ma advanced techniques and 
paradigms that are still 
essential, but perhaps 
not needed day-to-day. 
A great introductory 
chapter covers topics like 
debugging, abstraction, 
and types. As we move 
on to the assignment 
of variables, Rosenfeld 
does a grand job of beginning to 
peel back the layers and starting to 
elimpse the reasons for language 
decisions, such as why variables 
must be declared. It is this sort of 
detail that also makes it a good book 
on Perl 6 for those who can already 
program in another language. There 
are also more than a thousand 
code examples, and good exercises 
rounding off each chapter. 


Authors: Laurent Rosenfeld, 
Allen Downey 

Publisher: O'Reilly 

Price: £47.99 

ISBN: 978-1491980552 

magpi.cc/2vYO6KH 


Think Perl6 is aimed not 
so much at teaching 
Perl 6, but at teaching 
programming (to ‘Think 
Like a Computer Scientist’). Early- 
stage Python programmers will 
benefit from seeing what they’ve 
learnt re-examined in another 
language, and with Perl 6’s ability 
to work with modules written in 
Python (and other languages), 
Perl 6 may prove to be a good 
second language. 

The learning is split into 
two sections — the first eleven 
chapters covering the basics that 
any programmer needs to know: 
variables, expressions, statements, 
functions, conditionals, recursion, 


CNC MILLING 
FOR MAKERS 


Author: Christian Rattat 
Publisher: Rocky Nook 
Price: £22.50 

ISBN: 978-1681983028 

magpi.cc/2vYQNvI 


Score 


More specifically, Rattat tackles 
putting together the components 
of a Stepcraft-2/600 which, with a 
work area roughly the size 
of an A2 sheet of paper, 

; and a range of attachments, 
f CNC Milling is pretty popular. Readers 
~ Makers” considering a self-build, or 
>. ~“ purchasing another design, 
will still find plenty of 
useful and detailed material 
me. on general CNC machine 
construction, design, and use. 
Where this work loses 


Admit it: the thought 
of owning your own 
milling machine 

is very tempting. Perhaps you 


read the feature on Mark Buttle’s 
Pi-controlled CNC machine in 
The MagPi issue 39. The cost can 
certainly be spread by clubbing 
together and buying one for use 
at your local makerspace. The 
time involved in building one from 
scratch is not insignificant, and 
there’s a level of knowledge and 
access to tools that not all spaces 
will have. Given that, building 
from a kit could be much more 
viable, and Christian Rattat’s 
book tackles this latter case. 


utility is the lack of Linux- 
specific advice: Rattat only talks 
about proprietary software, 

and Stepcraft’s default USB 
microcontroller offloads the 
real-time control from the 
operating system. Discussion 
of the possible adaptations to 
use LinuxCNC would have been 
extremely useful here. 


Score 
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OURS TO HACK 
AND TO OWN 


Editors: Trebor Scholtz, 
Nathan Schneider 

Publisher: OR Books 

Price: £14 

ISBN: 978-1682190623 

magpi.cc/2vYdzUx 


A ‘guidebook fora 
fairer kind of internet’ 
that looks at emerging 
platforms froma 
cooperative standpoint. As Pi users 
work on building the Internet 

of Things, many are working to 
build the platforms for working 
together, and the infrastructure 

for connected devices, such as 
LoRaWAN networks across cities. 
This is the open-source way. 

The Silicon Valley way, by 
contrast, is investment driven, and 
needs to take control of the services 
used — cloud infrastructure, learning 
platforms, or online marketplaces 
— and ‘extract value’. Ours to Hack 


LEARN TO PROGRAM 


USING C++ 


ON THE RASPBERRY PI 
Author: Phil Gardner Le, 
Publisher: Zero-Index 

Price: £15.95 


ISBN: 978-0995791800 


<4 

magpi.cc/2vYR8yu 
rN 

: on the RASS 

C++, like Java, does neat 


not make a good first 
language — at least 
that’s the received 
wisdom. The Pi encourages Python 
and Scratch as beginner languages, 
but it also comes with a complete 
environment for compiling 
programs written in C and C++, 
and both of these languages 
feature extensively in embedded 
development. If building fun bits of 
hardware with small boards is what 
has attracted you to the Pi, then 
why not dive straight in to C++° 
Given the use of C-family 
languages in some GCSE and 


An easy intro 
for beginners 
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J ~ ” 
benny, Pi 


duction to Progr. 


am 
using Linux and ming 


GNU C++ 


and to Own is a wonderfully diverse 
collection of short essays, offering 
alternative visions for cooperation, 
but backed by numerous 
practical examples 
of cooperativism in 
action, such as the 
Fairmondo online 
marketplace, and various 
funding platforms. 
The writers are often 
politically driven, and 
it would be impossible 
to agree with all of 
them, but few essays fail 
to raise interesting points for 
consideration. And consider them 
we must, as the kind of internet 
to which we connect our hardware 
projects and startup ideas is far 
from settled, and will depend on the 
voices and efforts of everyone who 
wants an open platform on which 
to build. 


Score 


A-level curricula, there is another 
audience for a beginner-friendly 
euide. Long-time coder and teacher 
Phil Gardner gives us an example- 
rich, step-by-step guide, 
written at a level for just 
such new programmers. 
It’s a large-format 
book, which makes for 
clearly legible screenshots 
and code samples. All 
the essentials of C++ 
are covered in an equally 
matter-of-fact manner, 
from conditionals and loops, 
through arrays and functions, 
to structs and pointers. Much 
time is devoted early on to dealing 
with errors, as this is the aspect of 
programming most frustrating to 
the newcomer. Little is Pi-specific, 
beyond the ready-rolled compiler 
environment, but this is an 
excellent introductory text. 


Score 


BOOKS 


ESSENTIAL READING: 
INTELLIGENT PYTHON 


We live in golden times, with everything 
from essential algorithms to machine 
learning accessible in Python. 


Grokking Algorithms 


Author: Aditya Bhargava 
Publisher: Manning 
Price: £27.99 

ISBN: 978-1617292231 
magpi.cc/2vYBgMw 


A wonderfully visual guide to the 
algorithms most programmers need, 
backed up with simple Python snippets. 


Make Your Own Neural Network 


Author: Tariq Rashid 
Publisher: CreateSpace 
Price: £35.00 

ISBN: 978-1530826605 
magpi.cc/2vYNyEF 
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NELIRAL NETWORK 


Rashid gives you a layman's 
guide to neural nets (some maths 
involved), then clear step-by-step 
Jupyter and Pi implementations. 


Algorithms of the Intelligent Web 


Authors: Douglas Mcllwraith, 
Haralambos Marmanis, 
Dmitry Babenko 

Publisher: Manning 

Price: £27.99 

ISBN: 978-1617292583 

magpi.cc/2vZcgcA 


ML for web data with Python's scikit- 
learn, in an algorithmic guide to 
real-world data science problems. 


Thoughtful Machine 
Learning with Python 


Author: Matthew Kirk 
Publisher: O'Reilly 
Price: £34.50 

ISBN: 978-1491924136 
magpi.cc/2vY3VS4 


Aterser ML guide, with more 
maths and Python, but stilla 
fun and rewarding read. 


Beyond Zero and One: Machines, 
Psychedelics, and Consciousness 


Author: Andrew Smart 


Publisher: OR Books BEYOND 
Price: £14.40 ZERO 
ISBN: 978-1682190067 and ONE 
magpi.cc/2vYAPSv pea et feaweniens 
Alis missing the point, unless robots ANDREW 
can learn to hallucinate like humans. SMART 


A fascinating and convincingly a 


argued look at consciousness. 
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INTERVIEW 


We talk to the Mars Rover prototype engineers behind 


the new Kickstarter rover, powered by Raspberry Pi 


reated by the Mars Rover 

prototype engineers at 

Wroclaw University of 
Technology, Poland, the Turtle is a 
robust, waterproof rover that can 
be used to explore hidden worlds 


too small or dangerous for humans. 


Can you tell us about 

the Turtle Rover? 

Turtle is an open-source mobile 
robot designed to take every maker 
payload in a new environment. 

The rover is equipped with a full 
HD camera, watertight case, and 
a robotic arm. As it’s built around 
a Raspberry Pi with Raspbian on 
board, you can control it up to 
200 m away by WiFi with any web- 
enabled device (such as tablet, 
laptop or phone). 

Turtle can be used as a land 
drone for cave and urban 
exploration, as a development 
platform for navigation and 
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autonomy algorithms, and 
even for business, as a robot 
carrying special 3D-scanning 
or inspection equipment. 


Who is on the team? 

We are a team of five who met at 
Wroclaw University of Technology 
in Poland. Julia is a creative director 
and a graphic designer. She was 
responsible for the rover interface 


== 


— essentially everything the 
operator can see. Justyna is our PR 
and marketing manager, showing 
the world every detail of our work. 
Aleksander is the mechanical 
designer of the robotic arm and 
other external equipment. Marcin 
is our software and electronics 
engineer, and made everything 

to bring life to the rover. Iam the 
team head and chief mechanical 


- r ————— 
} 
. 
1 + 


It's easy to control from any internet-connected device 
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The Turtle Rover goes with 
you on your adventures 


engineer. I built not only the Turtle 
chassis, but the team as well. 


How did the idea come about? 
We’ve been involved in Mars rover 
prototype development since 2015 at 
Wroclaw University of Technology. 
Then part of our team worked on 
equipment for the joint ESA/DLR/ 
SSC BEXUS 21 mission that took our 
environmental study experiment up 
to the stratosphere. After working 
for science, we decided to establish 
our Own company and use our 
experience to design a ‘Mars rover’ 
for everyday users. From the start, it 
Was supposed to be extremely sturdy 
yet affordable, to show everyone 
that robotics doesn’t need to be 
expensive to be useful. 


Why the Raspberry Pi: 

We used the Pi in the university 
Mars rover design as well, and 
Turtle is designed to fit a Raspberry 
Pi 3. We are not only looking for 
hardware when designing the 
robots — the community is what 


interests us the most. The rover 
itself provides infinite possibilities, 
but it’s the people who need to tell 
you how to write image processing 
code or give the rover the brain to 
drive by itself. It’s a lot easier to 
talk to someone else when working 
on a project rather than keeping 
everything to yourself. 

As a team, we always loved 
the idea of an affordable mini- 
computer to fit into our work, 
and here we are. 


How waterproof is it? Can you 
explore underwater with it? 

The rover is watertight, which 
essentially means it can be 
submerged underwater, up to three 
metres deep. Every motor is sealed 
using rubber components, and 
both the boards and the battery 
are enclosed inside watertight 
cases. What’s more, there’s evena 
Special compartment to be utilised 
by the user. You can add your own 
electronics to the rover and still 
keep it watertight. 


Turtle Rover is watertight, 
so it can go almost anywhere 


raspberrypi.org/magpi 


The rover 
can explore 
awesome places 
with you 


The only thing with underwater 
use is to remember to keep the 
antenna above the water line. 
Almost every wireless signal cannot 
eo through water. Using the rover’s 
modular design, you can adapt one 
of its cases to act as a buoy to keep 
the antenna up — we plan to cover it 
in our blog. 


How long have you been 

working on it? 

With a five-year know-how 
covering similar mobile robots, 

we Started to work on Turtle at the 
beginning of June 2016. It was a 
year-round struggle to keep the 
rover functional, and to be able to 
produce it using mostly our internal 
resources. We don’t outsource the 
assembly, and we produce most of 
the components using 3D printing, 
CNC machining, and laser cutting. 
This is why we are So eager to 

get as much feedback from both 
our customers and open-source 
DIY builders as possible. As the 
production is super-elastic, we can 
provide swift modifications to the 
design to fit everyone’s needs. 
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FEATURE 


THE MONTH IN 
RASPBERRY PI 


Everything else that happened this month in the world of Raspberry Pi 


THE COMMUNITY'S 


Need more inspiration for your weekend projects? 
Check out some of these cool projects from our readers 


onday is not everyone’s 

favourite day of the week. 

However, we like to try to 
add a little fun to your morning with 
our weekend project roundup on 
Twitter. Loads of readers send us the 
stuff they've been working on over 
the weekend, and we love to see it 
all! Here are some of our favourites. 


OutRun Tomy toy conversion 


While we’ve seen many console and arcade hacks 
over the past few years, this inventive hack of one 
of those sports car dashboard kids’ toys wowed us 
when we Saw it. It doesn’t hurt that it’s themed 
around OutRun, one of the best arcade series of all 
time. Find out more here: magpi.cc/2xckwUo. 
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FRED-209 


A custom Nerf-firing robo-tank 
that gives you only 20 seconds to 
comply. We got a bit of a preview 
of this last month, and we’ve been 
excited to see the final product. 
Learn more about it (and see it in 
action!) here: magpi.cc/2xdabaQ. 


Hologram 


A nice, simple project using an 
engraved acrylic sheet and an LED 
Strip. Brian Corteil has managed 
to make avery lovely hologram- 
effect light, and we want one 

on our desk. 


Steering wheel 


Not just a simple steering wheel — 
this project is a custom controller 
for American Truck Simulator. 
Spencer Organ has been making lots 
of different custom pieces for his 
own special control setup. 
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EMERGENCY TRANSMISSION: 


e’ve received an alarming video message — 

you can watch it at rpf.io/pioneers. We don’t 

know this young woman’s name or exactly 
what has happened, but we must help her! If things 
are as bad as she says they are, our only hope of 
Survival is to work together. 


Steps to saving the world 


Bring togethera of up to five awesome thinkers 
and makers between the ages of 11 and 16, based 

in the UK or the Republic of Ireland, together with a 
mentor aged 18 or over. 


your team at rpf.io/ pioneers. 
Brainstorm something to help avert the crisis using 
, and then #MakeYourldeas by Friday 1 December 


— or else it will be too late. 


Get cool stuff, prizes, and save the world! 


Map out the zombies in the area. 
Stay safe! 


Create an app for your phone 


to avoid the zombies 
you mapped 
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Your team needs to build something to help this 
survivor in the treacherous situation she’s in. What 
you decide to make is completely up to you — it 
could be something to help you reach her location, 
something to help monitor supplies, a way to warn 
of approaching danger, or anything else you think 
would help. 

Any tech will do. This is an emergency, so you’ ll 
need to think creatively with anything you can get 
your hands on: laptops, cameras, microcontrollers, 
Raspberry Pis — anything at all. You can’t afford 
to be choosy, so you’1l have to be resourceful with 
whatever digital tech you have access to. 

You need to make sure you record your working 
process. Take photos and footage to document how 
you build your make, and put together a video to 
present your work when you’re done 
making. That way, even if things don’t 
work out quite as you’d hope, you’ ll still 
be able to show the work you put in — and 
we’ll still want to see it. Even the wonkiest 
prototype can be a Step on the road to the 
tech that saves the world from disaster. 
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FEATURE 


HELP RASPBERRY P 
CELEBRATE ITS 


The Raspberry Pi Foundation wants to put on a global celebration 
for its sixth birthday — here’s how you can help! 


or the last few years, we have held a big Get involved 
Raspberry Pi community event in Cambridge __If you’re keen to start a new Jam, there’s no need to 
around Raspberry Pi’s birthday, where wait until March - why not get up and running now? 
people have come together for a huge party with Then you’ll be an expert by the time the Raspberry 
talks, workshops, and more. We want more people Jam Big Birthday Weekend comes around. Visit 
to have the chance to join in with our birthday rpf.io/jam for more information, and submit your 
celebrations next year, so we’re going to be event to the map when you’re ready. 
coordinating Raspberry Jams all over the world Once your Jam is up and running, register it for 
to take place over the Raspberry Jam Big Birthday the birthday party: rpf.io/bdayjamform. 
Weekend, 3-4 March 2018. If you don’t fancy organising a Jam for our Big 
Birthday Weekend, but would like to celebrate 
Big birthday fun with us, keep an eye on our website for an update 
Whether you’ve run a Raspberry Jam before, or early next year. We’ll publish a full list of Jams 
you’d like to start a new Jam in your area, we participating in the festivities so you can find one 
invite you to join us for our Big Birthday Weekend, near you. 


wherever you are in the world. This event will be a 
community-led, synchronised, global mega-Jam 


in celebration of our sixth birthday and the digital NEED HE LP 
making community! Members of the Raspberry Pi 


Foundation team will be attending Jams far and wide STARTING A JAM? 


to celebrate with you during the weekend. 

Jams across the world will receive a special digital 
pack, and we’ll also be sending out party kits to 
registered Jams. 


RASPBERRY 


AWA 
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THIS MONTH IN Pl QQ THT 


KICKSTART THIS! 


Raspberry Pi projects you can crowdfund this month 


AutoPi.ic oa 7 : : . 
AUTOPI NOTAGRAMA 


kck.st/2wqOTGe | kek.st/awnR3Fa 


“What if your car had eyes°” the AutoPi Kickstarter A pretty cool product that uses machine vision 
video asks. It’s acar computer powered by Raspberry anda Pito read sheet music. You can lay out 

Pi that offers many enhancements over some of the music using chips or cards of specific notes on 
standard tech you find in modern cars. This includes the provided sheet, and it will read and play the 
monitoring of your car’s performance that you can music. It looks like a fun way to learn how sheet 
check online at any time, customisable if-this-then- music works and experiment with how melodies 
that events, and dash cams. come together. 


BEST OF THE REST 


Here are some other great things we saw this month 


This is cool: a Pi-Zero-powered 
guitar effects pedal that can be 
programmed to create different 
effects and sounds when you 
press it. It uses an extra board 

to handle the inputs, but a lot of 
processing is done on the Pi itself. 


magpi.cc/2yaVwvN 


PIXELBERRY PI (gee 


Not a physical project, but a TET ETT ETE TT ETT TTT guns Nerf turrets are fun, but this one goes a step further by 


wonderful pixel-art version of ste ae 7 a os adding facial recognition. It's powered by loT platform 
the Raspberry Pi by Retronator! = | iq Lene. : Fy ase 4 | n.io, and uses a Pi and laptop to look for targets by 
When we first saw it in a Twitter . irre, oo ees § Pan detecting faces. When a target is found, the Pi points 
thumbnail we thought it was a = ae ed | a | the gun to aim at the target's body. It looks to have a 


photo, which goes to show the a ee i a | beefy dart capacity, so unless you're Wonder Woman 
quality of this work. | in no-man's-land, you'd best stay out of its view. 
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Kelly Tagalan from Code Club Australia explains how kids 
around the world hacked the moon to set a new world record 


Children 

coded a special 
moon-themed 
project using 
Scratch, Scratch Jr, 
or Python 


n 15 August 2017, Code 

Clubs around the globe 

set a world record for the 
largest number of kids coding in 
a day! From Madrid to Manila and 
from Sydney to Seoul, kids in Code 
Clubs, homes, and community 
centres around the world used 
code in order to ‘hack the moon’. 
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The Moonhack 
movement 

The first Moonhack took place in 
Sydney in 2016, where Code Club 
set a record of 10207 kids coding 
in a day. 

The response to Moonhack — 
not just in Australia but around the 
world — blew the team away, and 
this year they decided to make the 
challenge as global as possible. 

“T want to create anything that 
can benefit the life of one person, 
hundreds of people, or maybe even 
thousands,” said one Code Club 
Moonhack participant in Australia. 

Preparation for the event 
required a lot of teamwork and 
collaboration within the global 
Code Club family. The Code Club 
New Zealand team helped to create 
and execute new projects with help 
from Code Club in the UK, while 


Code Club Canada, France, South 
Korea, Bangladesh, and Croatia 
all created translated materials to 
allow even more kids to take part. 


Moonhack 2017 


From the moment the clock 
struck midnight in New 

Zealand, children had 24 hours 
to try coding a specially made 
Moonhack project using Python, 
scratch, or Scratch Jr. Creative 
Moonhackers were encouraged 
to make their own custom 
projects, and there were amazing 
submissions on a range of themes 
— from moon football to heroic 
dogs saving our natural satellite 
from alien invaders! 
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Children from 
56 countries took 
part in the event 


COde) 
CFs ) 


The top five Moonhack countries Sydney to verify the record, and coding and programming. They 
submitting projects were we were thrilled to hear that we really enjoyed the challenge!” 
Australia, New Zealand, the USA, came close to tripling the number Of course, the most important 
the UK, and Croatia, but there of kids who took part last year! thing about Moonhack was that 
were contributions from so many the kids had fun taking part, and 
more amazing places, including Global Moonhacking experienced what it feels like 
Syria and Guatemala. The event The founder of Code Club to create with code. One astute 
was a truly international Code Bangladesh, Shajan Miah, nine-year-old said: “What I 
Club collaboration! summed up the spirit of the day love about coding is that you can 


create your own games. Coding is 
becoming more important in the 
work environment and | want to 


Kids had fun taking part, and 


experienced what lt feels like Se ne eee 
is is why we Moonhack: to 
to create with code get kids excited about coding, 


and to bring them into the global 
Code Club community. We hope 


In the end, 28575 kids from well: “Moonhack was a great that every Moonhacker who 
56 countries and 600 Code Clubs opportunity for children in isn’t yet part of a Code Club will 
took part in Moonhack to set Bangladesh to take partinaglobal decide to join one soon, and 
ame w me condunhecOnd omen eveime, lt eoimineciretal te Clmuillic vein Cloiele neiie exqoeie eines Wall Invellys 
founder and Senior Adjudicator, with like-minded people across euide them towards a future 
Corey Henderson, travelled to the world, and this motivated involving digital making. Here’s 
Moonhack Mission Control in them to want to continue learning to Moonhack 2018! 


If you would like to be part of Moonhack 2018, 


make sure you sign up at moonhack.com for 
alerts and news. 

If you're interested in volunteering at a Code 
Club, head to codeclubworld.org to find out 
more. There, you'll find information on starting 


a new club anywhere in the world. 
Kids got to work coding at Moonhack HQ 
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Ever the 

avid ‘geek girl’, 
Cat also dedicates 
time to hacking 
and digital making 


Certified Educator, Jam Maker, Teacher, 
Outreach Champion and much, much more... 


rom coding clubs to 

educational events, pi-top 

outreach and more, Cat 
Lamin has become a regular face 
within the Raspberry Pi community 
— and for good reason. 


Into the classroom 

With a BA in English from the 
University of Birmingham, 

there was no question as to the 
profession Cat saw herself working 
in. “I’ve known I wanted to be a 
primary school teacher since I was 
about nine,” she admits, going 

on to explain how her A-level 
choices in Maths, Further Maths 
and English helped to keep her on 
track, completing her education 
with a PGCE at the University 

of Plymouth. 


Cat went on to start teaching, 
with her speciality in Maths, and 
soon found herself lifted to the 
role of Head of ICT. “One of the 
children at my school told his mum 
that ‘Miss Lamin makes being 
geeky cool’, which was kinda cool,” 
she reveals. 

Moving on from teaching, 
although she still dedicates a few 
hours every fortnight to a local 
school, Cat now works in the 
computer science community, 
offering her services across a 
multitude of platforms and events. 
“T get to teach in a school local to 
me for an afternoon every other 
week, so I’ve just been teaching Year 
6 about interactive fiction, and can’t 
wait to bring in some Raspberry Pis 
for them to play with.” 


From the age of nine, Cat has wanted to be an educator. 
Through classes, educational talks, and coding events, 
she's reached more than the average classroom 
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Championing education 
For pi-top, creators of Raspberry 
Pi-based learning tools, Cat 
works as an Education Outreach 
Champion, running workshops 
and helping to grow the user 
community. Through pi-top 
she’s attended educational shows 
such as Bett, given talks at the 
Raspberry Pi Birthday Bash, and 
presented to the Argentinian 
Ministry of Education. “The other 
thing I do at pi-top is talk to the 
developers about their ideas for 


As part of her role with pi-top, Cat 
was recently sent to Argentina to talk to 
the Ministry of Education 


Evenings for teachers, offering 
a relaxed introduction into the 
world of computer science, and 
co-hosting Wimbledon Jam with 
Albert Hickey. “Occasionally,” 
she adds, “I’ve been known to 
organise something called a 
#eeekeat, which is just a meal in 
central London or in Cambridge 
where anyone who is part of the 
Raspberry Pi community can meet 


|. ae | 


She's continued to add to 
her role by running Coding 
Evenings for teachers 


software, to try and help them 
make it classroom-friendly,” Cat 
explains. She then works to put 
developers in touch with teachers 
who may be able to offer help 
and advice. 

Outside pi-top, Cat also 
dedicates her time to being an 
active member of the Raspberry 
Pi community. As a Picademy 
alumnus, she’s facilitated two 
further Picademy teacher training 
events, with her third due later 
this year. And if that’s not 
enough, she’s continued to add 
to her role by running Coding 
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FEATURED THIS ISSUE 


up with no pressure to do anything 
other than talk and have fun.” So 
when we Say Cat is active within 
the community, we mean it. 

Cat will be attending PyCon 
later this year to give a talk on 
mental health, a subject she feels 


strongly about, and hopes to help LINDA LIUKAS ALAN O'DONOHOE CAT LAMIN 
raise awareness for developers PROGRAMMER. CAS MASTER TEACHER RASPBERRY PI CERTIFIED 
STORYTELLER AND AND LEADER OF EDUCATOR AND CAS 


who suffer in silence. And moving 
on, she’ll be joining fellow 
Picademy alumnus and Raspberry 
Pi Foundation Member Sway 
Grantham in delivering advanced 
Scratch training at the National 
SIs Ceinitiee win |Dieceam cei. 


ILLUSTRATOR EXA.FOUNDATION MASTER TEACHER 
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WEST-VLAAMSE CODERDOJO 
RASPBERRY JAM 7) 
EVENT CALENDAR aS, 
Find out what community-organised, Raspberry Pi- a ee cue “2 
themed events are happening near you... om L @ somes oe 
/ oo & or, “al 
WESTSIDE oy eo 
RASPBERRY JAM RASPBERRY Pl ue 


JAM ISTANBUL 


: : J 
= 3 \ co 
ex , © & . / 
iw © | AJ 
oe a me 
vey. y, —— 
Ld -. | 
o/ MELBOURNE Pl 
Want a Raspberry Jam in s/ USER GROUP \ 
your area? Want to start one? 6 


Email Ben Nuttall about it: 


ben@raspberrypi.org 


AG alll, (Gla VMell ls leINihs REGULAR EVENTS 


HUPIJAM WEST-VLAAMSE CODERDOJO RASPBERRY JAM @ PI TOWERS 
When: Saturday 7 October RASPBERRY JAM When: Saturday 7 October 
Where: Harrisburg University, When: Saturday 21 October Where: Raspberry Pi HQ, 
Harrisburg, PA, USA Where: ARhus, Roeselare, Belgium Cambridge, UK 
mMmagpi.cc/2y7ghIW magpi.cc/2x8pKAh Mmagpi.cc/2x8pWzB 
A welcoming event where Together with CoderDojo, ARhus A family-friendly event where all 
you'll meet and learn from is organising the very first are welcome, providing coding and 
like-minded people ina West-Vlaamse Raspberry Jam digital making activities for children 
friendly environment. in Roeselare. and adults. 
RASPBERRY PI WESTSIDE RASPBERRY JAM CORNWALL TECH JAM 
JAM ISTANBUL When: Tuesday 24 October When: Saturday 14 October 
When: Saturday 7 October Where: Pearland Westside Library, Where: Bodmin Library, 
Where: Buyuk Milas Han, Pearland, TX, USA Bodmin, UK 
Istanbul, Turkey magpi.cc/2x9C9nH cornwalltechjam.uk 
magpi.cc/2y7DEIM Come and show off your Pi For anyone interested in 
A Raspberry Jam for those in and creations and learn each month technology, of all ages and 
around Istanbul, which hopes to about a different component you abilities. Ask questions and 


become a regular event. Calin WISE Oil Une Pi, learn about programming. 
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16TH EGHAM 
RASPBERRY JAM 
When: Sunday 15 October 
Where: The Glanty, 
Staines-upon-Thames, UK 
magpi.cc/2x8qXaT 
This month is Halloween themed, 
so come along and make some 
spooktacular Pi projects! 
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MELBOURNE PI USER GROUP 
When: Tuesday 17 October 
Where: Melbourne Rudolf Steiner 
School, Warranwood, 
VIC, Australia 
mpug.clarkson.id.au 
The group’s aim is to bring like- 
minded people together to talk about 
how they’re using the Raspberry Pi. 


WE'VE HIGHLIGHTED SOME OF 
THE AREAS IN NEED OF A JAM! 
CAN YOU HELP OUT? 


RASPBERRY JAM ADVICE 


SAFETY 


“Our venue, d university, required us to perform 
a risk assessment and have public liability 
insurance. | had experience with risk assessments 
from work, so that was straightforward, but 
anyone who doesn't have that experience can 
find plenty of examples online.” 

Andrew Oakley 

Cotswold Jam 


Every Raspberry Jam is entitled to apply for a 

Jam starter kit, which includes magazines, printed 
worksheets, stickers, flyers and more. Download the 
Raspberry Jam Guidebook at magpi.cc/2q9DHfQ. 


=? 
® RASPBERR 
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LETTERS 


x86 Stretch 


I upgraded my Raspberry Pi to the new version of 
Raspbian Stretch and really liked it. I’ve managed 
to misplace the disc with the PC version of the 
Raspberry Pi Desktop, and I was wondering if the 


version on there used Stretch or if it was still Jessie? 


Either way, is there a place I can go to download 
the ISO, as I’ve misplaced the disc? Thanks. 
Sarah 


The version of the Raspberry Pi Desktop for x86 PCs 
that came with issue 60 was based on Debian Jessie 
rather than Stretch, and has not been updated since 
the release of Raspberry Pi Desktop on Raspbian 
Stretch. We can point you to the ISO, as it’s available 
now on the Raspberry Pi OS download page at 
rpf.io/x86. 

If you need a guide to installing it on your PC, we 
have a new instructional video on how to do this, 
which you can find at magpi.cc/2xbvyJG. 
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The world’s thinnest Raspberry Pi 3. Image credit: Pimoroni 


A minimalist Raspberry Pi 
I’m aware you’re not able to get a kit to build a 
Raspberry Pi; however, it would be quite useful 
for me right now! I’d like to have something as 
powerful as the Raspberry Pi 3 and as slim as the 
Pi Zero, or even slimmer. 

I was thinking about the Compute Module 3, 
but I was wondering if there was a way to get a 
bare Raspberry Pi 3 board? Is it safe to take apart a 
commercial Raspberry Pi 3? I have a couple of spare 
ones laying around. 


Derek 


Great timing with this question! Pimoroni has just 
released a video on how to slim down a Raspberry Pi 3 
by desoldering all the ports and pins except the micro 
USB power port. You can find more information here: 
magpi.cc/2xco4WD. 

As for buying one, we don’t know of anywhere 
that will sell you a plain board, so your best bet is to 
follow Pimoroni’s instructions with one of your spare 
Raspberry Pi 3s! 


GETTING THE AIY 
PROJECTS VOICE KIT 


We're still getting emails from a lot of people asking 
how they can get their hands on issue 57 or the AIY 


Projects Voice Kit that came with it. Well, the good 
news is that Voice Kit is now available as a standalone 
product! The Pi Hut is taking pre-orders for the kit in 
the UK, and Micro Center in the US. Other retailers will 
also be stocking it. See page 10 of this month's News 
section for more details. 
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FROM THE FORUM: i, does anyone know when the 


Camera Module Essentials book 
is due out as a printed version? 
Andrew 


As we’ve done in the past, once we’ve ICAMERA! 
completed a new series of Essentials books, } { ODULE 
we’ll do a print run and they’1l be available 


in our store, and from Amazon and other 


The Raspberry Pi Forum is a hotbed suppliers. We can’t say yet when that will 

of conversations and problem-solving be, asevenwe don’t knowquite yet. We =$_s 
for the community. can assure you they’re coming, though. 

Join in via raspberrypi.org/forums If you can’t wait until then, you can 


always print out a copy of the Camera 
Module Guide using the PDF. As it’s licensed 
under Creative Commons, we let you 

do that — you could even go to a proper 


2 The Camera 


printer and get a nice glossy version Module Guide covers 
for yourself! Grab the PDF from here: Sv ery MING younecd te 

. . know to get started with 
magpi.cc/2ufdjnT. the Camera Module 


WD PIDRIVE NODE ZERO 


Build your own mini DLNA + Samba file server, wireless 
mobile storage device, a Pi Music Box with local storage 
and so much more. 


Includes: 

¢ 314GB WD PiDrive, Raspberry Pi Zero, 
and custom adapter board 

¢« SD card with starter software 

¢« Mini HDMI adapter cable 
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© WD LABS Learn more at wdlabs.io 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark of the Raspberry Pi Foundation. microSD is a trademark of SD-3C, 
LLC. The term HDMI is a trademark or registered trademark of HDMI Licensing LLC in the United States and other countries. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies 
depending on operating environment, Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates, 


@ @ code 
club 


j 
START A CODE CLUB 
IN YOUR SCHOOL! 


Code Club is a network of volunteers and educators who 
run free coding clubs for young people aged 9-13. 


Our aim is to inspire the next generation to 
get excited about computer science and digital making. 


“We use Code Club's fun educational resources to runa 
weekly after-school club for Year 7 and Year 8 pupils. The 
students benefit considerably from the extra challenge!” 


Karen Dadd, Computing Teacher 


M4 Code Club is free 


4 Code Club provides step-by-step guides for 
Scratch, Python, HTML, and Sonic Pi 


M4 Code Club helps children develop skills including 
logical thinking, creativity, and resilience 


We have over 6000 clubs across the UK teaching 
more than 80,000 young people to code—come and join us!" 


Find out more at www.codeclub.org.uk 


Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 65 
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magpi.cc/2udLQQ3 


Enter now at 


Terms & Conditions 


Competition opens on 27 September and closes on 26 October. Prize is offered to participants world-wide aged 13 or over, except employees of the Raspberry 

Pi Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the 
competition, the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The 
MagPi magazine. We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no 


cash alternative will be offered. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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sa tothe most efficient learning 


was a graduate school student in New York 
City in 2012 when the extremely destructive 
hurricane Sandy made landfall on the North 
Atlantic coast of the United States. Our student email 
eroup was especially active at that time. Classes were 
cancelled and students were checking in as safe, 
reporting problems, and helping each other out. The 
email threads told a story about what was going on at 
the time, and so I wanted to capture and present that 
story outside the context of email. I wanted to take the 
story told by the emails and put it into my own single- 
edition physical book. 


Python project 
To accomplish that, I spent a full weekend figuring out 
how to get Python to read emails from my account, 
process them, and create a PDF to send to the printer for 
publishing. It started off as a simple enough idea, but 
the complexity began to reveal itself as I worked on the 
project. How do I number the pages° How do! split up 
the chapters? How do I create a table of contents? How 
do I solve the problem of odd characters in the emails 
that were wreaking havoc with my Python script? 
During that weekend of figuring out how to turn email 
messages into a printed book, | probably learned more 
about Python than I have at any other time in my life. 


Creative learning 

Just a few days ago I was reminded of this experience 
when I came across a great piece of advice on Twitter 
from Seattle-based data scientist Jake VanderPlas 
(@jakevdp). He tweeted, “My advice on learning 
Python: Don’t set out to ‘learn Python’. Choose a 
problem you’ re interested in and learn to solve it 
with Python.” 
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MATT RICHARDSON 


Matt Richardson is the Executive Director of the Raspberry 
Pi Foundation North America and author of Getting Started 
with Raspberry Pi. Contact him on Twitter @MattRichardson. 


/ CREATING 
TO LEARN 


-_ In Matt Richardson’s experience, creating projects leads 


Jake’s tweet perfectly sums up what I learnt first- 
hand while toiling away to create a physical volume 
of hundreds of email messages. Having a particular 
project in mind when you use any technology (and 
not just Python) is the best way to learn it. Creating 
something new provides a clear objective, and 
you get more out than you put into it. You bring 
something new into the world, and you learn a lot 
along the way. 


Real objectives 
Having a clear objective for what you want to achieve 
gives you more drive to learn. I believe that this is 
one of the reasons why project-based learning is 
such an effective methodology. You’re not learning 
only for the sake of learning. Learning by creating 
something gives you the opportunity to apply 
what you learn, and gives you the determination 
to get it done. There’s more satisfaction in creating 
something you wanted to make than there is in 
solving a hypothetical problem. 
When you’ re creating with technology, you’re 
not only learning about that technology, but also 
developing some of your soft skills. Rarely does 
a project come to fruition without a little bit of a 
struggle. Creating projects often takes patience, 
persistence, and grit. These are characteristics that 
you won’t learn in a textbook or from a lecture. 
After a lot of persistence getting my Python script 
just right, I sent the file to be printed as a bound 
volume of emails. When I received it in the mail the 
following week, I was so pleased with how the project 
turned out. The source of much of that satisfaction 
was how much I learnt in order to achieve that goal. 
I didn’t just learn to create. I created to learn. 
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Build your own credit card 
sized computer 


Get started with programming 
Set up a Media Center 
Make simple electronic circuits 


Raspberry Pi board and case 
Power supply and HDMI cable 
Pre-Programmed Memory Card 
Over 49 electronic Parts 
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Available in Europe 
Available for worldwide shipping at: through RS Components 


$389” £69°° 


US DOLLARS EXCLUDING VAT 
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